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PALM 

DEVELOPMENT 


By Erik Sea 


Palm OS for Mac OS Programmers 


Similarities make Palm development 
natural to Mac programmers 

So You Want to Program a Handheld... 

I can remember the first time I saw an Apple //c, I had Lo 
have one. 1 must have used that machine more than any other 
at tlie time, despite the fact that the monitor weighed as much 
as a neutron star, llien, when I saw the PowerBook 170, l stood 
in line to get one of those as well Newtons held some promise, 
but died on the vine before they had a chance to take off. 
Smaller (or at least lighter) PowerBooks have made their way 
through my collection, will continue to do so as long as they 
keep getting better (hard though that is to image). So, since a 
Palm OS device can do so much less than a PowerBook, why 
would 1 need a Palm? More importantly why would a Mac 
programmer want to program a Paint? 

There is something intrinsically attractive about computing 
power that you can cany around with you* Now, my PowerBook 
G4 is a great device (I’m writing this article on it), but it doesn't 
go everywhere I go. The Palm can (actually, right now 1 carry 
around a Kyocera SmartPhone 6035 that runs Palm OS - see 
Figure IX IPs not a question of “switching" from Mac to Palm - 
the Palm is handy for quick, mobile access to data, but the Mac 
is better for creation and otiler “heavy lifting' 1 tasks* 



Figur e L Kyocera SmartPhone running Palm 05, 


So, i still do work on both. And thankfully for the would-be 
Palm programmer, there are a lot more similarities between the 
Mac and the Palm than you might realise (particularly if you’re a 
veteran 68k programmer). Even more delightfully, the preferred 
development environment is a Mad Of course, you can use 
Windows too, if you really warn to... 

Let s start with a sampling of what the Palm OS looks like from 
a runtime and Aid perspective, before we start talking about tools. 

Palm OS Inside Out 

One of the first things to realize about Palm Powered devices 
is that they aren’t computers. Well, technically, they are 
computers, but this isn't a miniature laptop, and shouldn't be 
thought of like one, Palm has deliberately not tried to put versions 
of all the familiar desktop applications into its devices, and the OS 
is not designed to support feature-bloated word processors or 
complex spreadsheets. In fact, lacking a keyboard by default, 
Palm devices are not well suited for intensive data entry; rather, 
they are intended for use as data retrievers. 

Fundamentally, there arc architectural differences because 
you use a Palm differently from the way you use a Mac. You can 
think of a Mac (or other desktop if you must) as an authoring 
device on which you create your data, and the Palm as the 
device you download that data to so that you can have it with 
you wherever you go. 

The best way to gel your head around what environment 
you've got to work with on a Palm is to think of the Macintosh 
of just over a decade ago. 

Yon remember the 68000 , right? 

The original Macintosh was powered by a 68000 chip, and 
until the adoption of the PowerPC different Motorola 68k chips 
ran every Mac (and also the LisalX As luck would have it, the First 
Palm devices had a variation of the 68000 - the 68328 - as its 
processing core. Despite the different digits at the end, if you 
know 680x0 assembly language, then you know the 68328 and 
its architecture for the most part. 


Erik is a long-time Mac programmer who recently joined Palm Inc,, where he is a project manager working with Palm OS licensees. He lives in Zephyr 
Cove, Nevada, where he trains Bluetooth-equipped siinkys lo form ad-hoc wireless piconets with stranded skiers and then feed them brandy. You can 
reach Erik at sea@acm.org. 
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For the curious, the 68328 (also called a DragottBal!) is 
more than just a processor - it has a numtxr of built in 
peripherals, inc luding a serial port, LCD controller, and real-time 
clock. Subsequent Palm OS devices from various manufacturers 
have featured newer chips, such as the 68FZ328 (DragonBalJ 
EZ) and the 68VZ328 (DmgonBall VZ). Longer-term, Palm has 
announced a long-range plan to migrate its OS to the ARM RISC 
chip architecture - mirroring the Mac migration to PowerPC 
several years ago. History tends to repeat itself! 

Getting and handle on memory? 

Your classic Macintosh memory model consists of 
Pointers, which are fixed in memory, and Handles, which 
can be relocated to avoid memory fragmentation. Palm OS 
has the same ideas, and the same terminology r however, the 
Handles are “opaque” - they can be converted in to usable 
pointers only by locking them (which you probably ought to 
be doing anyway on the Mac), mi her than by a simple 
deference (you don't need to know how handles are really 
implemented, and you shouldn't care): 

MemHandle attend It? * NULL: 

MesPtr aPtr * NULL: 

aflaridle = ftemHandleNev (ItSoilfiSizeTnBytcs): 
aPtr = MemHandleLock (aHandle) : 

// Use aPtr- 

(void) Hendtefidiettnlock (attendle) ; 

// aPtr is not guaranteed u> still be good at this point™ 
(void) KemHandleFree taHandle) : 

Another riling you'll notice from the above code snippet 
is that, in Palm OS, all calls are prefixed with the name of ihe 
manager to which the call belongs. For example, "Mem” 
prefixes memory manager calls, “FmT prefixes form manager 
calls, and “Srm" prefixes serial manager calls. In this way, not 
only can you tell whar header to look for the prototype, but 
the names tend to follow a predictable pattern, without need 
for contortions in the global API namespace. The same son 
of conventions are followed for constants. Errors are 
assigned ranges by manager such that the first byte 
determines Lhe manager “owning" the error, and the last byte 
determines the specific error within that manager (you really 
want to read these in Hex). Cool, no? 

Palm OS also shares another legacy with Mac OS. Some 
of you may recall that the original Macintosh was based on a 
24-bit addresses (because that's all the original 68GUQ chip 
had). This limited the amount of memory that a Mac could 
use, until “32-bit clean" versions of the ROM and OS shipped 
(’round about System 7 time). The reason this limitation 
persisted was that, as an optimization, the “unused" 8 bits of 
the address were used to track things such as whether or not 
a handle was locked, and so on. Because of this, Macs were 
limited to 8 MB for a long time. For similar reasons, the Palm 
OS through the present version, 4.0, is limited to 24 bits of 
address space, although the use of the remaining 8 biLs is 
somewhat different and not quite so limiting, and a Palm 


device can have 16 MB of RAM (and more space for other 
storage, including ROM). 

One user application at a time? 

On a Palm device, you run on application at a time 
(actually, different tasks and processes can be launched into 
the background, including user applications, but we'll get to 
that in a moment). Does this sound like the Mac before the 
advent of MultiFinder? Users never actually quit the front 
application - they just perform an action that causes another 
application to launch: after all, why should one have to quit 
and then launch when launching with an implied quit 
achieves the same result in half a.s many steps? 

You can. however, do multiple things with a Palm device 
at the same time, like (on devices with the appropriate 
hardware or add-on sleds or cards or modules or sticks or...) 
play music while you download your email and view 
pictures. There can, however, only be one process that 
interacts with the user running at a given time (this is called 
the HI Task) - but with a screen small enough to fit on a 
portable device, you probably don't want multiple 
applications cluttering up precious real estate anyway, just 
know that your application might be asked to run in the 
background under some circumstances, and that has 
implications for what you can and cannot do. 

Interprocess events, globals and shared memory? 

One thing you'll see in a Palm program is Him, unlike on 
the Mac (and most other places), your main routine can gel 
called under different circumstances and with different 
parameters (l suppose that’s like a command line Interface), 
In fact, your main routine can even be re-entered under some 
circumstances: for example, if the user does a “Find” while 
you application is run, you will gel reentered to do the Find 
without your main routine having a chance to exit. 

However, if you start to think of these parameters as 
somewhat like Apple events, but without a separate handler 
mechanism, it doesn't seem quite so strange - it's just a 
simplified single-channel means of interprocess 
communication (although in most cases, communication is 
from ihe OS much like the standard event suite on the Mac). 

These parameters can ask your application to do all sorts 
of useful things. Or, you can send these launch codes to 
system applications, preference panels (which are actually 
just applications of a special class) or other applications you 
know about. It's generally OK if you don't handle most of 
these launch codes when you start developing your 
application, but study the sample applications that Palm 
provides and you’ll gel an idea of how you can use them and 
which ones it’s important to support. The first of these 
parameters, or launch codes, determines whaL she other 
parameters mean. See Table 1 for a partial listing (any listing 
is going to be partial - new- codes are added regularly). 
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'fable 1 - Application Launch Codes 


Not all is Hiss in this world, however Launches with some 
launch codes don't provide you with access to your global data, 
so you'll need to be creative alxwe getting at it. 


Palm OS, tike the Macintosh 68k runtime architecture I before 
it, sets up global data tor the foreground application using 
offsets on register AS, Since all applications run in the same 
memory space, and some of these launch codes are sent to your 
application when it’s not the foreground app, in those eases AS 
will lx* for the oilier application, and not yours. You can get 
around this by saving your data elsewhere, or, if you know 
you’ve got a valid A5, you can save and restore it (this is not 
always as easy as it sounds - remember, your application quits 
when another one runs, so the next time you run you 11 probably 
get a completely new ASX 

The gtxxl news is that, although memory is shared, it’s 
pretty hard to wipe out somebody eise’s data - there is 
protection of database memory, and pretty much everything on 
the Palm OS, except the heap, is in databases which have 
restrictions on how you can access them. Even applications are 
databases. The moral is that you should store important data in 
databases, rather than caching it in changeable memory. 
Database access is just about as fast as memory access, so there's 
not really a need for optimization. 

Where do applications, files, and databases live? 

One of the pretty interesting things about a Palm device is 
that there really is no file system to speak of (well, technically, 
OS 4.0 added a file system complete with VFS abstraction layer, 
and some devices had one before that, but the basic operational 
model is still one of no file system at alt and well ignore the 4.6 
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file system for this discussion). Applications are stored in 
addressable memory, and they run from that memory in place. 
Unlike conventional systems, there is no cofrying of applications 
and data from disk or other secondary storage to memory and 
back for a program to run. This simplifies the OS dramatically, 
and makes applications launch very quickly. 

Addressable memory isn't necessarily *RAM W though. As 
discussed earlier, present-day Palm devices can have up to 16 
MB of RAM, but they can also have up to 16 MB of ROM (in 
most erases, this is Hash ROM of some sort), and all of it's 
addressable at the same lime. The OS and most built in 
applications live in ROM, and they run directly from this ROM 
space. Sec Figure 2. 



figure 2 . Typical Palm OS Memory Map, 


On a Palm device, RAM is preserved at all costs - user data 
and installed applications live in RAM, and even under reset 
(except for a “hard" reset which restores a device to factory 
configuration), the contents of RAM are preserved, it is a 
common misconception that applications get installed into Flash 
ROM in order to be persistent - this is not the case. If the user 
runs down their battery, they lose their installed applications and 
their data (which is why users are encouraged to IlotSync their 
devices frequently, in Older to keep a bac kup in case they forget 
to charge their device for a couple of weeks!) 

Some details: application code segments are limited to 64K 
in size (for reasons similar to the 32K limit on the 68k Mac), but 
you can build multi-segment applications to get around that 
limit. Palm applications, though, rend to be quite small - think 
alxuit how much simpler a program could be if it could still 
manipulate data but didn’t need any knowledge of a file system! 

Of course, as mentioned above, on OS 4,0 (and selected 
earlier devices), there is a file system for dealing with various 
expansion media. Interestingly, since the Palm evolved a 
programming model without a file system, the question of file 
names and forks never arose except in some contexts, so the 
designers were free to invent some new ideas - although at least 
the building blocks should look familiar. 

How does my application get “found'" if it's not a file? 

A gtx)d question. Without a file system, it was necessary to 
divide memory into logical tin its which could be accessed in a 
reliable way. These units are called “databases 1 *, and every 
application is a database, and die data which an application 
processes lives in one or more databases too. Even the system 
preferences are stored as records in a database. 


These databases do have names, and the names need to be 
unique, but there’s another concept here that should be familiar 
to Mac programmers: databases have four character creator 
codes and four character types. Application databases are of 
type appl 1 , for example. Creators are registered for your own 
use (sound familiar?). Now, there are some additional properties 
of creators on a Palm device that you haven't seen on a Mat' - 
if you remove an application with a specific creator code, then 
all databases with that creator code will 1x j removed. (Now, 
don’t you wish Lhat rhe Mac had some reliable means of tidying 
up the preferences folder?) The down side of this is that all 
means all - if you have multiple applications with the same 
creator, all of them will be removed when one is removed (but 
maybe you’ve developed a multi-application package and want 
lhat to happen as some sort of “uninstall"?) 

How do I localize my application? 

Once you start looking at the various pieces that make up 
these databases, you’ll notice another familiar component: 
databases are divided into resources, which are identified by 
integers and four character axles, file user interface resources 
can thus be localized independently of the code. In OS 4.0, there 
is even a system of "overlays" whereby it is possible to have the 
luealizable code for multiple different languages stored in 
different databases from die code, anti let the system switch 
Ixnween them at runtime. However, since memory is precious, 
this particular technique is generally only useful for the ROM of 
the shipped product. 

Palm OS does not, however, have the Idea of separate 
resource forks and data forks, primarily because there were no 
files, just databases. If anything, you can think of Palm OS as 
only having resource forks, and when databases are backed up 
to desktop computers, those resource forks are just peculiarly 
formatted files stored in the data fork, avoiding the whole 
multiple fork issue for the most pan (except during 
development, but that’s getting ahead of ourselves). 

What if I need to change some part of the OS? 

With the 68k architecture comes die whole idea of A-trap 
exception handling, which the original Mac used to implement 
the operating system - and so does a Palm device. No, the traps 
will be different numbers, but you've- got the ability to patch 
traps if you really need to, just like on the Mac. 

However, 1 would caution you not to do this. You’ll 
probably break under future versions of the 08, and you could 
break on different devices dial have various background 
processes which run periodically. Unlike on the Mac (or, just like 
die original Mac or a Mac OS Extension), when you patch a Palm 
trap, you patch it globally. 

The gtxxJ news about patching is that, because the OS was 
written with a single runtime, there is no funky confusion of 
Pascal and C calling conventions to deal with. There are some 
places where parameters are in registers, buL that's not usually 
needed (and you can always revert to writing assembly glue). 

Palm OS also has Extensions and Shared Libraries for 
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larfOPekend You wei* a terrible 
fjjdSp; ana quite unditriittivq, but 
T&iff h»art is cdvioualy pun? gekt 
My shim would be perfect lor ytiu 

»?aa? 


VEGETARIAN BOWLER, You 
bough* ptw a warm boor and r.iote 
my iwTiin Used same kind a* ball 
& p.,n and sip-nkc? o( liutresJ ul nenlesi 

SI! slwfij Wouhl low la cun! over 
huirtrnuft *5604 

GORGEOUS* WITTY, BORN TO 

LAWN CARE? My husband go! lazy toaso fovo thcMtbf. ttoi'icn. golf, 
arid iHted you to mow otn fawn warm cniwarsaikm It yotiYo tall. 
Kl older Instead you landscapscl my erotic 35-Rfk nonsnvdtor, timirtcLiiiy 
FworklnQ funtasros in ways l have never unarj’ seoure, enjoys p;itup£«HH^yy|| 
prfh curly tried Codd hot prtnKnince your |i^wNt>fL Jeau^gMrinpWPl 

tvti lunch y name but rooked vary sensual t had 

blue shoes on *3686. 4^^* 


RON FROM SANTA FE, Yliu 
danced wnh rue at llle Rattle- & 
Cattle Glut), T hanks l l wn* shy Can 
I see you Again? Writ come ekjwn to 
took Tor you Fiktoy night *Hi(M t 


SUPERMAI 


ME: LONELY SWEDISH LINGERIE MODEL 

and gourmet cook. You: slightly overweight 
and without ambition. Must be into computers, 
role-playing games and air hockey. *r5988 


C0 W LE ' M m ' TWINS WHO SAW TWINS Ufi 

i i iy day. ‘ iditcls<i i s io i> iys> in stispencler v .mH 

vr J^jMF u . I would mu MaJloee Von two k)*y kte\mT 
■Tn Dki t road Pujimno two* last (meet? nt <jtmvr:. 

do you suy Hh? tour rrf us mak&vo 
U':x>d looking couptes 9 Twin 

Hcph ONE-PLAYING CaH rne Ca» me. *>4 n / ^ 

wlIlL 1 roccnfly 

^Rrrurpra *fi&M DU GOUT FIRECRACKER You 

were- cJdarHirg up a btef that you 
HfwE MET in MADISON, spikaJ on yunr while t-Bhlrf arid 
HRmimer Wuutd like in calk threw a whr&key buttle At line 
H^aDii irtjEHr/ uruplTe Musi rueei you and make 

ehiktren »S55i 

■pROM WCW. Lwhanged 

■Fes at cage match It was pure LORIN, YOU’RE GORGEOUS, 
^Klc Wouki tuve to gel you In a fuinrty and tmkiam J dun'r deitervo 
■ppfir lifltd w]jO 07,.' you hut a girl can dr-saw 

HaUTIFUL and SEVENTEEN: SY FROM DOWN SOUTH Ydtt sat 

■m vfV jtif tbi) Meitro. Y6n wen? on a vyilh ys at SnHHy> \ V24. -thl^d 


ing | 

& 
good ki: 

C4»u mek 

MANY WONl 

stiy tito - but no 1 *, 
woodedui woman, 


overweignn^ImP^NHHHWwwnWpMli^^^^tycnte. petite,. 

wickeil iente til iuurndt, and a weud DWT. 4iL lung hrnwn t iair Tia^dl 
vkrw ol trfc louring lor kko nMrnk'd eyes. S' 110 nutoiog pmr.unality 

person. Ago not nrfinrtam w0th)4 souks IAVN, 48-56, non smoker, frt, 

uoHygo OduccHed Call me. lei's see 
TREE HUGGER, MID 50’$. light H Hio crioitwsiiy ij oght 11 «fiD5i; 
smoker, LiU Like easy living, tunics 
and I'm Incmdly Ruekmg consider- 
ato. somI HI coimpAttkH) wiiti a due 
Musi love dogs and reggae. M$£ ■ ., 


MONKEY TRAINER. Seeking 
wnman t<? trsin my monkey 

^erj’Ousiy, f;, 5 nRnvi is Murphy and 

id M 

tikes pep. tuifs and nice people. 
Plus, ybii aiwH wSUTtive sen 
'=7074. 


smtart. pmifeM^iaj; au„ 
u tiwp«pwlcay .lovd<tTttat«iv. 

SINGLE MAN, $;nyie rmtit ^e-kirtg : : watiwn badidh wp#2 :: ..:--.: 
MiwowoHMulur m'dlwhip t 


AW:.YOU HONEST, baittlwm:. 




We f re Easier. 

Create anything from prototypes to full professional applications. Just drag and drop interface 
elements while REALbasic handles the details. You concentrate on what makes your stuff great — 
your ideas! REALbasic creates native compiled applications for Macintosh, Mac OS X and Windows 
without platform-specific adjustments. It’s the powerful, easy-to-use tool for creating your own 
software. Each version of your software looks and works just as it should in each environment. 

Complex problems shouldn’t require complex solutions. The answer is REALbasic. 


$ REALbasic 

Download a free demo, www.realbask.com 















customizing and plugging in to various parts of the OS, but as 
these are fairly specialized I won't go into them here. 

How do I handle user events? 

Event handling is a bit different in Paint OS than Mac OS, 
but the good news is that Palm OS event processing is somewhat 
similar to the Mac’s new Carbon event model Every form (as the 
basic HE elements of a Palm screen are called - this is really the 
contents of a window and not the window itself} has its own 
handler, and events are passed to that handler which can either 
process them or let the system handle them. If the system 
handles them, an action could occur, or the event might lie 
requeued as a more specific event. For example, a pen down 
event might change to a control select event which might be 
translate to a control change value event and so on. 

OK, what about all those special Palm OS features? 

Sure, there probably are no Mac equivalents to things like 
Beaming (transmission over Infrared or maybe Bluetooth) or 
synchronization with a desktop (HotSync). The gtxKl news is 
that many applications don't need Lo do anything to work within 
these environments - your application will (>e Inclinable, anti 
your application and its databases will lie backed up by HotSync 
without you doing anything. You do need to do work to beam 
records back and forth between instances of your application on 
two different devices, but that is relatively well documented and 
you should be able to just modify an example. 

If you need to lie able to have your data reformatted for 
sharing with a desktop application, youll need to delve into the 
area of HotSync Conduits, which are pieces of code that live on 
the desktop and are linked to Palm-based databases by creator 
code. Youll need to write conduits for each desktop platform 
you plan to support, and it can become a fairly involved process. 

B is far more important, at least initially, to realize that 
you Ye not writing a desktop application than it is to try to take 
advantage of all of these features. Your screen is 160 pixels 
square on most devices (some devices provide a bit more real 
estate, or even high resolution 320 pixels on a side), and on 
some devices the physical dimensions are really quite liny. 
Consider that your application might l>e used in a jostling car. 
or in puor light conditions. Also, the pen you tap with does 
not move a cursor around like a mouse does (except, 
conceptually, in the case of a stroke), so that does change 
what you might lx j used to in terms of interface behavior 
Read some of the books on Palin programming, and study 
design decisions in sample applications! 

This sounds almost too good to be true? 

It's not. Sure, there are some differences, and if you do 
work on both platforms you’ll find yourself forgetting what those 
differences are at inconvenient limes, but that is mostly because 
the .systems are so very similar 

The Palm and the Mac evolved under similar circumstances: 
limited processing power and memory, and the need to make do 
with less. It is not surprising that the solutions Lo these problems 


were so similar (particularly with die model of the Mac’s 
evolution to follow and in some cases improve on). Why 
reinvent the wheel? Why indeed. And the same can be said for 
development tools. 

Tools 

As a Mac programmer, you’ve probably played w r ith 
CodeWarrior. You might even have written a PowerPlanr 
application and used MetroWerks Constructor And, at some 
level, you've probably played with Macsbug, So, these first 3 
tools should look like old friends, 

MetroWerks CodeWarrior for Palm OS! 

The same 68k compiler as provided for the Mac, plus a 
number of extra plugins and tools give you a very familiar 
application development environment. Hie MetroWerks source 
level debugger allows you to slop through code as it is executed 
on a device connected over a serial link, or you can dispense 
with the device and run your application on the Palm OS 
Emulator (discussed shortly). 

In order to take advantage of as many existing tools as 
possible, you can create .rsrc files using tools like Constructor 
and ResEdit to edit resources, and the linker itself generates code 
resources which all gel merged into an output file. You can also 
write resources in ,r files and compile them with PalmRez, very 
muc h like the ,r files native to Mac development. 

Thai output file, though, is just a temporary file and requires 
some post processing to put ii into ^Palm” format (usually a 
JJ prc” file if an application), and that is done using die PalmRez 
Post Linker. The panel for this conversion tool is one of the ones 
where you need to make some changes almost immediately 
when you start a new project or else things won’t work quite 
right. The most important thing is to fill in or change the 
database name this is the name of the database that is your 
application, and it must be unique on die device. A common 
convention is to include the creator code (which should also lie 
unique and registered, as discussed earlier). See Figure 3 for the 
PalmRez Post Linker panel. 



Figure j. PalmRez Post Linker settings. 

Other settings are pretty' self-explanatory - die 1'irsL editable 
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THURSBY 

Software 


-The f i(e,<fhre felkS* 



My files are 
important. 

Very important. 


I only share my 
files with those 
I trust. 

I trust DAVE. 



Mac is a trademark of Apple Computer, Inc, f-eglstered in the U,S. 
and other countries. The Built for Mac OS X* graphic te a trademark 
of Apple Computer, Inc., used under license. 
dave is a registered trademark ofThursby Software Systems, Jfllc. 

© 2002, Thursby Software System*, Irtt, 


DAVE 


Mac to PC, PC to Mac. Cross-platform 
file and print sharing is too vital 
to your business to risk. Trust 
Thursby, the company with 15 years 
experience. Trust DAVE, the solution 
with a proven track record. Share 
files and printers across a network 
with no barriers. DAVE installs on 
your Mac with no additional software 
required for the PC. It's fast, secure 
and easy to use. Download a free 
evaluation today! 


Trust DAVE. 










text field (“Mac Resource Files 1 ) is the name of the temporary 
output file that was specified in the Lt 68K Target” panel (in this 
case, “Starter, tmp"), and the final outpuL file is in the third 
editable text field (here, “Starter, ptc"). The various checkboxes 
are pretty well explained by balloon help. 

Demo or limited versions of GodeWarrior for Palm OS come 
with several of the Palm programming books which you can 
buy, Metro Werks GodeWarrior for Palm OS is a completely 
separate product from the Mac and Windows (and embedded 
systems) versions and, although you probably could merge tools 
and create a hybrid development environment, chances are 
you’ve already got more than one Mac version of GodeWarrior 
installed in order to handle separate projects, so why not just 
keep the Palm version^) separate as well? 

Constructor for Palm OS! 

Originally developed for PowerPlant on the Mac, 
Constructor was easily modified ro support the forms needed for 
the Palm OS user interface. If you've worked with Power Plant, 
you will find Palm OS Constructor familiar in functionality, but 
of course all of the objects and components are pretty different. 

The main project resource window in Figure 4 has a 
number of important settings youII want to play around with, 
“Application Icon Name*, is die user-displayed name that shows 
up in the Palm OS launcher with all the other applications* You 
can also use constructor to generate headers with relevant 
constants for these forms, which can be quite handy for 
maintenance. 



Figure 4 Palm OS Constructor resource file. 


The various data types in the resource file have specific 
editors; youll find the menu editors quite familiar (of course, 


there are no key equivalents, bur there are Grafitti shortcut 
equivalents). Figure 5 shows a blank form, ready for controls to 
lie deposited on it. 



Figure 5. Empty Form window ready for edit. 


When you finally decide to put items on the form, you can 
select from the Catalog window, much as you do in Constructor 
for PowerPlant, except the selection of items is much smaller, as 
can be seen in Figure 6. 



Figure 6, Palm OS Constructor available items , 
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Palm OS Debugger! 

Once youVe built a Palm OvS application, you'll probably 
need to debug it. Most of the time, you should lie able to make 
do with the source-level debugger built into Code Warrior, but 
sometimes such as after a bad crash you’ll need lower level 
tools. In steps the Palm OS Debugger, which comes up with 
three windows: Registers, Debugger, and Console. Usually, 
you 1 11 type commands into the Debugger window, but another 
set of commands can f>e typed into the Console window . Some 
commands work both places. 

The easy way to see what commands are available, is to 
type “Help”. After typing a command, you must hit "Enter”, and 
not 'Return 11 - this should make you feel like you’re using MPW 
again, just like the old days. For reference, the commands 
available from the Debugger window are shown in Listing 1, and 
from the Console window', Listing 2. 


Flow Control Commands 
att 

g [<addr>] 
gt <addr> 
s 
t 

br <addr> 

cl f<addr>l -at- bre f(addr>l 

hrd 

att> (<* , funcN3me M > I <A trap #>] 
|ttC [(”l'uncName") | <A ltap #>] 
atd 

breakpoints 

dx 

reset 


;Attach to Remore 
:Go 

;Co Till 
[Step Into 
[Step Over 
:Set Breakpoint 
:Clear Breakpoint(s) 

;Display Breakpoints 
[Set A Trap break 
[Clear A Trap break 
:Display A Trap 

[Turn DbgBreaks on/off 
:Reset the Pilot 


Memory Commands 

11 [<addr> [(llneCount)] ] 
dm <addr> [(count>1 [(template)] 
db <addr> (value) 
dw <addr> (value) 
dl <addr> (value) 
sb <addr> (value) 
aw <addt> (value) 
el (add r> (value) 

fill <addr> (rbyxes) (value) : 

fb (value) <addr> (nbyLes) <\flags) 
fw (value) (addr) (nbytee) <\flags> 
fl (value) <addr) (nbytes) <\flags> 
ft (text) <addr> (nbytes) <\flags) 
sob [<addr> [(frames)] 1 


sc7 f(addr> [(frames)]1 
wh [CfuncKamc 1 *) | <A-rrap #) 
routine 

atr ("funcNameO (A t rap #> 
with an A-trap number 


[Instruction List 
Dfsplay Memory 
;Display UlntB 
[Display Ulntlfc 
:Dispiay Int32 
:Set UlntS 
[Set UInti6 
[Set Inti 2 
"Fill Memory 
[Find tllni'8 
[Find Lflntlb 
[Find Int32 
:Find Text 
[Stack Crawl A6 
[Alias for sc6 
[Stack Crawl A7 
\a (address)] [Where in 


[Register routine name 


Template Commands 

typedef (template) [@. . . ] ("name*’) f([eltsl>] [Indirect 

template definition 

typedef struct ("name") [Begin 

structure definition block 

> (template) 1§...]("name") [([ells])] 1 \-] [Field 

definition 

typeend :End 

structure definition block 

sizeof (template) [Display 

template size 


Register Commands 
reg 


[Display all Registers 



Fetch 4.0 


Walk the dog. 



Fetchsoftworks.com 

More Features ■ Fewer Bugs 
Bigger Icon 


February 2002 * MacTf.ch 









Utility Commands 

load <“filename*} (addr) 

Host into RAM 

save ("filename") (addr) kbytes) 
Host 

bootstrap ("filename") (addr) 
using EZ bootstrap roods 
flash ("filename") (addr) 
from Host Into FLA S Ft memory 
run <'‘filename") 

Debugger script 

alias ("name") [("text*)] 
var ("name") [(initializer)] 
aliases 
templates 
names 

variables 

names 

keywords 


;Load Pile Dato Fork from 

;save RAM to file on 

:Losd b execute image 

;Load File Data Fork 

;Execute a Pilot 

:Define/list an alias 
;Define a variable 
:List ail alias names 
:List all template 

ildst all variable 

IList all keywords 


Console Commands 
Cardlnfo (cardNo) 
information 

Storelnfo (cardNo) 
information 
HL <cardNo> 

IP (heapID) [WI 
HT <heaplD> [\c] 

HChk (heapID) [\el 
Info (chunkPtr) 
information 

Tnfo (localID) Ward (cardNo) 
information 

Dir (cardHo) [(options)] 
directory 
Opened 


:Display memory card 

:Display memory atore 

ilteap List 
;Heap Dump 
:Heap Total 
;Heap Check 
;Display chunk 

; Pi splay chunk 

^Display database 

;List open databases 


Miscellaneous Debugger Commands 
help 

debugger commands 

[help <cmd>] | I<cmd> ?} 

command help 
? 

help command 
penv 

Envir onment Info rma tio n 


;Display a summary of 
Display debugger 
; Abbreviation for the 
:Display debugger 


Debugger Environment Variables: 
DebOut 

output enabeld(true/false) 
SymbolsOn 

printing enabled(true/false) 
StepRegs 
every step 
RendMemHack 
enabled(t rue/false) 

Predefined Constants: 
true 
false 
srTmask 
srSmask 
bit 

srlmask 
Field mask 
srXroask 
srNmask 
bit 

srZmask 

srVmask 

bit 

srCmask 


:debugger-debug style 
;disassembly symbol 
;shov registers after 
tread memory hack 


:integer value 1 
^integer value 0 
;status reg Trace bit 
IstatUS reg Supervisor 

:statua reg Interrupt 

;status reg eXtend bit 
:status reg Negative 

;status mg Zero bit 
:status reg overflow 

:status reg Carry bit 


Listing I - Palm OS Debugger “Debugger” commands 

- Heap Utilities 

HeapList 

Heaplnitialize 

HeapDurap 

HT 

HC 

HChk 

HTomire 


HS 

HF 


- Chunk Utilities --- 

New 

Free 

Lock 

Unlock 

Info 

Resize 

SetOwner 

• Database Utilities - - = 

Import 

Importail 

Export 

Exporta 11 

Create 

Del 

Dir 

Open 

Close 

Opened 

SetInfo 

“ Record Utilities - 

AttachRecord 

DetadiRecord 

AdilRecord 

DelRecord 

ChangeRecord 

ListRecords 

SetRecordTnfo 

WoveRecord 

FindRecord 

= Resource Utilities ’ 

CetResource 
LI stResources 
SetResourcelnfo 
AttachResouree 
DetachResource 
AddResource 
DelResource 
ChangeResource 

= Card Info - - 1 1 - - - - 

CardFormat 

Cardlnfo 

Storelnfo 

= System —-- - 

Reset 

Doze 

Sleep 

Performance 

Exit 

PowerOn 

ColdBoot 

Launch 

Switch 

Battery 

Ping 

Feature 

KInfo 

* Debugging Utilities 
DM 

SB 

MDebug 

" Miscellaneous Utilities “ 1 

SiraSync 

SysAiarraDump 

= Host Control "--- - 

Lor 

Help 

= Gremlins Commands ——■— 

Gremlin 

GremlinOff 

Help 

listing 2 - Film OS DebuggerTon.scHc’ commands 
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LOOKING 


GOOD 



T Install My Insanely Great Application for Mac OS X 


*™—MW**— 


Install My insanely Great Application for Mac OS X 


Choose Product Features 


install features for Desktop Users 

The man comman applitalien fc a Lure * will be Jam nl ltd. Thb 
oplmn h fecornmEnried Tor mail pltrl, lnm^will bt MiHfdlo 
Lhc Dock, PoWtl Mil G4 deiklop UeH jind iMit tiled Will be 
vejy hippy wiili ihii up Lion, 


Introduction 
License Agreement 
Enter Password 
■ Choose Install Folder 
Dock Icons 

f y Choose Product Features 


Install Features for Users On The Go 

This ii Lhi! fccDjnmcndtdl aplion (at uicfl oh lhc go. PowcrSCok 
and iBook u»r> wilt t» lhc envy of their envarken. 

All yuur Uni ire belong Ed ui. 


Install Selected Components 

hot iurc Whji yuu want loin via It? Think different ChwM* ihij. 
ti pi ion and pick (he individual eomponenl^ to I nil all. 


previous J f install ^ 


Looking good on Mac DS X is easy with InstallAnywhere! 


let's face it first impressions are lasting ones. You don't build 
beauliful applications for Mac OS X only to deliver them with 
yesterday's tired installers. 

Zero G has created a powerful and intuitive installation and 
configuration solution that is true to today s Aqua look and feel. 

InstallAnywhere has complete support for Mac OS X r such as 
authentication, file permissions, and platform specific locations 
including installing icons into the Dock, making it the only 
installer you’ll ever need. 


And when you're ready to deploy to Mac OS Classic, Linux. Solaris, 
AIX, HP-UX* or even <gasp!> Windows, InstallAnywhere is ready 

too anytime, anywhere, on any platform. 

Software innovators like Adobe, Apple, BEA, Borland, HP, iZ, Iona, 
Sun, TIBCQ and Xerox already depend on InstallAnywhere for their 

software deployment needs. 

See for yourself why InstallAnywhere, the world's leading multi- 
platform deployment solution, ts also the best looking and most 
powerful installer for Mac OS X. 




v> 


ZERO G 



InstallAnywhere 


Download a free trial version from http://www.ZeraG.cam/goto/macosx 


t? KKJl Zera £ Software, me. IrsiaHAfiphierc and ZeroG sc trnfemirta critpskred tiiikmacJLi si ZeroG SoitiMie. Ire. Mae: ts a tndenafk of tome Ccnuutef, Iik.. ftpsiEWi 
*nd dhflT mirides, 11* 'Buill tor HhcOS K’ sraoNt is«IwtHiuikof AdbIe CuntHtef Lne.. uwnl under license. All ulto tritkitarlu mrc mterivif tirir rttpeebet owners. 



























If you've played with Macsbug much, a lot of these 
commands should look pretty familiar - not surprising given lhaL 
Macsbug came from Motorola (the “Mac" part is a coincidental 
acronym). Typing “sc" produces a stack crawl as you might 
expect; here’s one l generated by dropping into the debugger 
while 1 had the Find dialug open: 


Current UT App stack: size - #4560 
Calling chain using A6 Links: 


A6 Frame Frame Size 
0QQ3C6CG #0000003292 

_Startup + OODO 

0003C69A #0000000044 

PiIotMaln+00F4 
OO03C66A #0000000048 
EvcrntLoop+O]AB 
0003C6 3 2 #0000000088 

3y slland leEvent+0014 
QO03C5FE #0000000020 
0003C500 #0000000254 

0003C4B4 #0000000076 

F rmDoDia1ng+0080 
00Q3C4CE #0000000070 
P r vRa nd1eKo dalEven t +0042 
00Q3C454 #0000000026 

Sy sHand1eEven t+OQ14 
OO03C44O #0000000020 


Caller 

10006562 

10D06DC4 

10DCF08C 

1QC10B4A 

10C11370 

10C67574 Find+OOC2 
10C61460 

10C61104 

10C10B4A 

10C1151C 


Another handy trick is that (remembering Figure 2), the 
addresses in ROM normally start at l t and the RAM addresses 
start with 0, 


The command “iP similarly produces an instruction list from 
the point where you entered the debugger: 


10CU51C 

* K0VEQ . L 

#$Cl,DO 


| /001 

10C1151E 

0400 

ERA, W 

*+$0402 

: ICC11920 

| 6000 

10C11522 

TST.B 

D3 


t 4A03 

10C11524 

BEQ.S 

*+$0006 

; 1QCU52A 

| 6706 

10C1J526 

JSysLaunchConsole 

: $J0C102OA 

| 4E6F A0BE 

10C1152A 

H0VEQ.L 

vsoi.no 


| 7001 

10C1152C 

G3F2 

BRA.W 

•+S03F4 

: IQC11920 

| 6000 

10C11530 

TST.B 

D3 


| 4A03 

10C11532 

BEQ.S 

•+S0016 

; 10C1I548 

1 6714 

10CH534 
00 IE 

MOVE.B 

#$!E.-(A7) 

; V 

] 1F3C 


And the very useful “hd 0" command produces a heap display 
quite like that of Macsbug (see Listing 3). 

Displaying Heap ID: 0000* mapped to O0OGIBQO, first free: 
00002736 

req act lek 

reaType/ #resID/ 

start MemHandie locallD size size ent own flags type 
Index a Ur ctg uniquelD name 


*00001E3S 000Q1B14 000Q1B15 000010 

000018 


fo 

fH 

DraOp enRef: ’System 1 

“O0OO1E5O 0000IBIS 00001B19 000024 

00002C 

#i 

#0 

fM 

DmGpenTnfoFtr: ‘System* 

“OOODIFJC O0GG1R1C 00001HID 0O013C 

000144 

#i 

#0 

fM 

MemHandie Table; 1 System" 

-OOOO1FC0 OOOO1B20 0GU01B2I 000010 

000018 

#i 

#0 

fM 

DmQpenRe f; * Sys t em_enU S * 

•0DG01FD8 COO CUB24 00001B25 000024 

00002C 

#i 

fo 

fM 

DmQpenlnfoFtr: "System enUS* 
“00002004 00001B28 00001B29 000284 

OO028C 

#i 

#0 

fM 

MemHandie Table: "Sy5tem_enU5‘ 
“00002290 00001B2C Q0001B2P 000010 

000018 

#i 

fo 

fH 

DmGpenRef: 1 Latin Locale Module' 
“OOOOIZAB 00001B30 0Q001B31 000024 

000020 

#i 

#0 

fM 

DmGpenlnfoPtr: "Latin Locale Module* 
*00002204 OOOG1B48 00001B49 000010 0000IS 

#i 

#0 

fM 

DmOpenRef: "Latin Locale Module enUS* 
-0OQ022EC 00001838 0000IB19 000022 00002A 

#0 

#0 

fW 


Alarm Table 


*00002316 OOO01B34 QGO01B35 0000/4 00007C 


#0 

fH 

MemHandie Table; ‘Latin Locale Module' 
*00002392 00001B4C 00001B4D 000024 00002C 

h 

#0 

fM 

DmOpenlnfoPtr: ‘Latin Locale Module enUS' 

*000023BE 00001B50 OG001BS1 000014 OOODJC 

_#i 

fo 

fH 

MemHandie Table: ‘Latin Locale Module entlS 
000023DA 00001B3C OOO01B3D 0002EA 0002F2 

#0 

fo 

fH 

Notify Manager Globals (SysNotifyGlobalslype) 
•000026CC 00001B68 0QQ01B69 000010 000016 #1 

fo 

fH 

DmOp enRef ; * Launehe r * 

‘OOO026E4 00001BSC 00001BSD 000024 0OOO2C 

fl 

fo 

fH 

DmOpenlnfoPtr: "Launcher' 

000027LO 00001B40 00001B4! OOOOIE 000026 

#0 

fo 

fH 

DataMgr Protect List (DmProtectEntryPtr*) 
00002736 - 00002/36 000000 000000 #0 


FH 

-> 

00003BDE 

•0000273E O0O01B58 00001B59 OO0O38 000040 

#1 

fo 

fH App 

Globals; HI Shell 

-0000277E 00001B6C 00001B6D 000456 Q0Q45E 

# 0 

fl 

fH 

Graffiti Private 

*00002BBC 00001844 0GOO1R45 000030 000038 

#1 

fo 

fH 

MemHandie Table: ‘Launcher* 

*00002014 00001064 0OOO1B65 000010 000018 

#1 

fo 

fH 

DtnGpenRef: ‘Launcher enUS* 

“0OO02C2G 0OO01B70 0Q001B71 000024 00002C 

#1 

#0 

fH 

DmOpenlnfoPtr: ‘Launcher enUS* 

*00002058 0OO01B54 00001B55 00015C 000164 

fl 

fo 

fH 

MemHandie Table: ‘Launcher^enUS* 

*00002D8C 00001860 0O0O1B61 000900 000908 

fl 

#0 

rn App 

Globals; Current U1 App 

*00003604 00001B84 00001BBS 0003A4 0003AC 

fl 

#2 

fH Form 

*"1:08 am" 

•00003A70 00001B80 00001B81 000OEE 0000F6 

fl 

#2 

fH Form 

"Find** 

•00003B66 00001B74 00001B75 000028 000030 

fl 

#2 

fM UI: 

Window (160*64) 

“00003B96 00001B88 00001BB9 000010 OO0O18 

fl 

f2 

fH 

'OG0Q3BAE OOO01B/S OO001B79 OO0028 000030 

fl 

n 

fH UI: 

Window (2x11) 

00003BDE — 00003BDE 034E78 034E80 #0 

#0 

FH 

-> 

0QO3955E 

• OO03SA5F,- 00038A5E O0OAF8 OOOBOO #15 

f J 

fm 

01: 

Blimap (160x64x3) for window 3B66 

0003955E — 0003955E 001CE2 001CEA #0 

fo 

FM 

-> 

00040004 

•OQ03B248 - O0C3B24B 000026 00002E #15 

f2 

fm 

UI; 

Bitmap (2x11x8) for window 3BAE 
•00G3B276 - OO03B276 000200 000206 #15 

fo 

fm 

Serial 

Manager receive buffer 

■0OO3147E Q003B47B 00007C 000084 #15 

fo 

fm 

Serial 

Manager open port {SrmOpenPortType) 
•00038502 — O0O3B5O2 0O1IDO 0C11D8 #15 

fo 

fm 

Stack: 

Current UI App 

•0003C6DA - 0003C6DA 00003C 000044 #15 

fo 

fo 


SysAppInfoPtr: Current HI App 
•0003C71E - 0003C71E 000020 000028 #15 

fo 

fm 


•OO03C746 - 0003C746 00D586 00058E #15 

fo 

fm 


Bluetooth Exchange Library globals 
•0003CCD4 0003CCD4 000018 000020 #15 

fo 

fm 


•O003CCF4 - 0003CCF4 00003E 000046 #15 

fl 

fm 


BtTransport H4 globals 

•0003CD3A --- 0003CD3A 000016 000022 #15 

fo 

fm 

Serial 

Manager driver data (DrvrPrivateGlobs) 
•00O3CD5C - 0OO3CD5C 000020 000028 #15 

#0 

fm 


•0003CD84 - 0003CD84 000074 00007C #15 

fl 

fm Graffiti 

Glue Globals (GrfGlobalsType) 

•0O03CEOO O0C3CEOO 000/DO OO0/D8 #15 

#0 

fm 

Stack; 

Ul Shell 

•0003D5D8 - OO03D5D8 00003C 000044 #15 

fo 

fm 


SysAppInfoPtr: UI Shell 

•0003D61C - 0003D61C 0OOO3A 000042 #15 

fo 

fm 


Attention Mgr Globals 
•0003065E — 0003D65E 000168 000170 #15 

#0 

fm mi 

Color table stack 

•0003D/CE - 0OO3D7GE 000064 00006C #15 

fo 

fm 

UI: Undo 

buffer 

■0OQ3D83A - 0OO3D83A 000118 000120 #15 

#0 

fm UI: 


Event Queue 

•0003D95A - Q003D95A 0OOOOC 000014 #15 #0 fm 

Shortcuts Library globals 
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“Awesome!” 


"The power, quality and feature sot of 
l asso Professional 5 is very impressive. 
The new documentation is definitely 
among the best in the business." 

Johan Solve; Hatmstad f Sweden 


"Blue World has managed to add an 
immense amount of functionality and 
scalability without sacrificing any of the 
ease-of-use of previous versions New 
features like LassoApps, custom Lags 
and LassoScript create a development 
environment that seems almost limitless.“ 

Tom Wrebe. Vancouver, Canada 
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s Lasso 

S Professional 





"With Lasso, I have been able to single- 
handedly develop sophisticated solutions 
lor internal and external use in less time 
than I see teams of people take with 
other middleware languages." 

Greg Witliis; Santa Ana r California 


"This new release, t have got to admit, 
is truly amazing. The rich array of new 
features, the brand new documentation 
and the amazing new administration 
interface make Lasso Professional S 
definitely worthy of a purchase." 

Brian Olsen; Brooklyn, New York 


Upgrade today to the most powerful Web application server for 
Macintosh and beyond and you'll discover why so many Web 
developers claim Lasso Professional 5 is the must-have tool for 
quickly building and serving powerful data-driven Web sites. 

Lasso Professional 5 introduces a next-generation, object-oriented 
Web programming language, advanced Web application server 
administration, an embedded Lasso MySQL™ high-performance 
database server, a new distributed architecture, new platform and 
data source support, unprecedented extensibility and customiza¬ 
tion, 1800 pages of rewritten documentation and over 200 new 
features and enhancements. Lasso Professional 5 provides vast new 
power and features while maintaining the legendary ease-of-use, 
performance, and reliability that make Lasso the preferred tool for 
tens of thousands of Web developers, ISPs, and IT/I5 professionals. 

If you're serious about building and serving data-driven Web sites, 
but don't want to spend a serious amount of time getting it all to 
work, there's no better choice than Lasso Professional 5. 



Lasso Administration controls your entire setup via an 
attraction and intuitive Web browser interface. 



Visit the Blue World Web site today and see how Lasso products can nRH 

help you quickly build and serve powerful data-driven Web sites. 

Lasso Database Browser provides instant access to ail 

Lasso - The Leading Web Toots for Macintosh and Beyond your databases, without writing a line of code 


blueworld 

www.blueworld.com 
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■ QOQ3D96E - 0003D96E OOGGQ4 OOC 

Application defined sub-font list 

* OOQ3D97A - OO03D97A 0000! 0 OOC 

AppFontTable 

-000311992 00030992 000020 OOC 

SysfontTable 

-0003D9BA - U003D9BA 000006 OOC 

globals 

■0003D9C8 -- O0O3D9C8 000028 OOC 

Library globals 

-0003D9FS -- 00Q3D9FR 0CQO0F OOC 

Library loci glabals 
-Q003DA0E OOO3UA0H 00001A OOC 

Manager Global* (SndClobalsType) 

-0003DA30 -- 0003LA30 ODOD24 OOC 

Manager Globals [KeyGIobaisTvpe) 

-QDQ3DA5C — QOG3DA5C 000040 OOC 
Queue (KeyQueueType) 

-0003DAA4 - Q003DAA4 000100 00C 

Qtj eu e (?e n Q u eu cTy pe) 

■0003DBAC 0003DBAC 000023 OOC 

Event Manager Globals (SysEvtMgrGlobalslype] 


#15 

#0 

fm 


#15 

#0 

fra 

HI: 

#15 

#0 

fra 

UI: 

#15 

#0 

fm 

Net.lib 

#15 

flo 

fm 

TrDA 

#15 

#0 

fm 

ExgLocal 

#15 

#0 

fm 

Sound 

#15 

#0 

fra 

Key 

#15 

#0 

fm 

Keyboard 

#15 

#0 

fm 

Pen 

#15 

#0 

fra 

System 


•0003DBDC - 0003DEDC 000200 000208 #15 

Driver; color translation table {8-bit) 

"0003DDE4 -- G003DDE4 000020 000028 #15 

Driver: color translation table (4 bit) 

• OITODEOC - D0O3DEOC 000008 0000ID #15 

Driver: color translation table (2 bit) 
•GG03DE1C OOC3DE1C 000004 OOOOOC #15 

Driver; color translation table (1-bit) 
.0Q03DE28 — 0GC3DE2B OOOOAO OOOOA8 #15 

state stack 

■O0O3DEDO - 0003DEDO 000028 000030 #15 

Window (160x160) 

*0003D?00 OOOOOFOO 000082 DOOOBA #15 

Driver: row pattern buffer 

-0003DEBA - QGG3DFBA 0OOOB2 OOOOBA #15 

Driver; expanded scan line 

*QQ0312074 -- 0003E074 00G4C4 GQQ4CC #]5 

Driver Globals (ScrGlobalsType) 

-0003E540 - 0003E540 000039 000042 #13 

Interrupt Handler Hot! flea Lions Qutntt* 

*0003E582 U003E382 000092 00009A #15 

Mgr Globals (Variable - IntlClobalsType) 

-00U3E6IC G0Q3E6IC D0002C 000034 #15 

Manager Globals (PenGlobalsType) 

*0003EG50 - Q003E650 000009 000012 #15 

Manager port description: "Infrared" 
*0003E662 0003E662 000007 000010 #15 

Manager port description; "Serial" 

• 0003E6/2 - OOOm/2 0G0D/E OOOQS6 #15 

Globals (SerGlobalsType or SrntGiobalsType) 

•0003E6F8 - 0003E6F8 000010 000018 #15 

Manager Globals {AlniGlobalsType) 

-0003E710 - Q0C3E710 000018 000020 #E5 

Manager Globals [TlmGlobalsType) 

•0003K730 - - GD03E73G 001/48 001 /bO #15 
Globala 

-G0G3FR8O G003FE80 OOOOUG 000044 #15 

5y*Ap|rtttfoFtr: AMX 

-0003FEC4 0003FEC4 000030 000038 #15 

Data (SysBatteryDataStruct) 

-00Q3FEFG - Q003FEFG 000038 000040 #15 

globals 

‘0G03FF3C 0003FF3C OOQOGO OOOOC8 #15 

Library Tabic 


#0 

#0 

#0 

#0 

#0 

#0 

#0 

#0 

#0 

#0 

#0 

#0 

#0 


fo 

§0 

#0 

#0 

#0 

//o 

#c 

#0 


Heap Summary: 
flags: 
size: 

nujxHandles: 

Free Chunks; 

Movable Chunks: 

Non Movable Chunks; 
Owner 0: 

Owner 1: 

Owner 2: 


2000 
03E500 

too 
« 

#53 

0060F2 bytes 
000520 bytes 
001048 bytes 


(036872 bytes) 
(GQ1D9E bytes) 
C0058BG bytes) 


fm Screen 
fiti Screen 
fm Screen 
fm Screen 
fm 01: Draw 
fm 01: 
fm Screen 
fm Screen 
fm Screen 
fm 

fm Inf I 
fm Pen 
riu Serial 
fm Serial 
fm Serial 
fm Alarm 
fm Time 
fra Kernel 
fra 

fin Battery 
fm PowerMgr 
fm System 


Unlabeled System Chunks; #1 


listing S Outpul oi command “lid O' 


Palm OS Emulator! 

Willi the t(X)ls already discussed, you have enough to do 
everything you need. ikiL wait, there is one tool i lint is so useful, 
you should lie aware of it, and lliat is the Palm OS Emulator 
(usually called “POSE* or “POSER"). This tool takes a Palm ROM 
file (obtainable from the Palm OS developer site mentioned in the 
Tor More Information” section! and allows you to simulate a Palin 
device on your Mac, as shown in Figure 7. You can even use the 
CodeWamor debugger, and the Palin OS debugger with POSE. 



Palm OS' Emulator 


| 1:2? om| 

I-..,. J' 

v All 

@L 

# 

# 

Address 

Calc 

Date Book 

CD 



HotSync 

Moil 

Memo Pad 

# 



Prefs 

II 

Security 

To Do List 

Welcome 




Figure 7 Palm OS Emulator "POSE". 


Why would you want to use POSE rather thin a real device? 
Well, you probably should use a real device for at least some of 
your development/testing, because POSE simply will not 
simulate a device perfectly, However, during initial 
development, ii is much more mnvemeni to be able to compile 
and run an application in the emulator than it is to compile an 
app, HotSync it to a device, and then nan it. You can “install" 
files in the emulator, too, just by dragging them to [he window. 

But in addition to mere convenience, POSE also provides 
additional parameter checking on API calls before passing them 
to the ROM, and many problems or potential problems can be 
detected that way. To lap if off, POSE provides a 
psuedorandomhed test method called “Gremlins" which can lx; 
used to stress an application or group of applications, You can 
create a “Hoarde" of Gremlins and leave if rim for hours or days 
at a time. And, by using the same seeds (the “Range” in Figure 
8), you can run the exact same test repeatedly (provided you 
reset POSE so that all initial conditions are the same). 
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Figure 8. FOSE Gremlin test window. 


You May Already be A Palm OS Programmer 

So, as you can see, if you're a Mac programmer you already 
have a distinct advantage should you want to start programming 
Palm Powered devices. And, since you can do it all with tools 
you know, and do it on your favorite computer, why wouldn’t 
you? Although there is an effort to maintain tool parity, Palm OS 
itself is developed and built on Macintoshes, 

More pragmatically, many people believe that the handheld 
market is going to exceed the size of the desktop computer 
market in ihe coming years, and since Palm OS currently holds 
nearly 90% of that market, learning Palm OS is a gcxid 
investment or skill diversification. And, it’s fun. 

I d like to thank Cliris Simmons, Linus Anderson, and 
Paul McLellan for taking the time to provide input and 
suggestions on lhis article. 

For More Information 

* http://www.palmosxom/dev/ is the Web site for Palm OS 
developers - download agreement to get access to various 
developer tools, including ROM image files for use with 
POSE, You can also obtain Debug ROMs, which have a lot 
more error cheeking which may be useful in development, 

* http://www.fatbrajn,com/palmdeveloper/ has Palm OS 
documentation available in printed form, 

* Palm Programming; The Devetojter’s Guide , 1999 by Neil 
Rhodes ik Julie MeKechan, is one of die first, and most 
broad-ranging Palm OS books written. This edition is a bit 
dated (based on Palm OS 3-OX but it provides good coverage 
and is still pretty relevant. It includes a demo version of 
Metro Works CodeWarrior for Palm. 


Study bugs? 



Or KILL them? 



New Version 

Upgrade Now $29 
www.onyxtech.com 

Dei ecc afrale hand lea, runtime block ov&rwri t&s, 
Bisposeilandle on resources^ invalid BlockMoves , 
writes to location Validate Handle/Pointer 


Webmasters! Start your web hosting 
business with edition.net reseller hosting! 

* dedicated platforms 

* single and multi-domain hosting 

* your choice of Mac OS or Linux platforms 

* FileMaker Pro hosting featuring Lasso 

* QuickTime streaming server 

* Our web-based control panels make it easy to 

* deploy your multi-domain server 


edition.net - 
the Fine Arts 
Network 


http://wwwxtlidon.iiet * info@ediiion.net 
+1 (877) 225-3821 toll free * +1 (562) 430-5953 international 
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BOOK REVIEW 


By Andrew Downs 


Palm OS Web Application 
Developer’s Guide 


Introduction 

1 recently purchased the book OS Web 

Application Developer's Guide by lien Combes et al 
(Syngrcss Publishing. Inc.) My original intent was to use 
parts of the book to validate my work on a Web Clipping 
Application (WCA) prototype. However, after completing 
my spot-checks, I realized rhai ibis is exactly the type of 
book that would have saved me a lot of time during the 
application design and implementation phases. If you are 
working in the web clipping arena, you probably need 
this book. 

If you are familiar with Palm Inc.'s developer 
documentation, you know there are some useful PDF docs 
and sample code available, but the cutting-edge Palin OS 
technologies are not easy to figure out in a short 
timeframe. Part of the problem involves having to search 
and traverse the web site looking For information. Having 
the most important information available in one book is 
very convenient. 

What's in the book? 

The topics include several that you would expect: an 
overview of web clipping, constructing WCAs with text 
and images using the Palm tools, using forms in your 
application, session tracking, and customization (based on 
the users current location, definitely cool). There are 
even a few relevant history lessons. 

Each chapter includes a Frequently Asked Questions 
section at the end, as well as a checklist of the major 
points disc ussed {with brief descriptions). The latter, tilled 
Solutions Fast Track adds a nice touch. My only complaint 
about this area is that the book's sole appendix is simply 
a consolidated reprint of all those checklists. 

Most chapters indude sidebars aimed at improving your 
deployment success rate, helping you locate bugs more 
quickly, and so on I found the various lips relevant and 


informative. Plus, they break up the reading just enough to 
get your attention. 

There are more HTML examples than C examples; so 
source code junkies in the audience might be inclined to 
regard this as yet another non-prog ramming book. Don’t 
make that mistake. The C examples are few but get the 
point across clearly. Plus, writing HTML pages that render 
well on a Palm device is not an easy task, especially if you 
are attempting to distill the typical desktop browser- 
oriented web page. Hence, the need to discuss HTML. 

If the ever-growing number of device and network 
configurations makes your head spin, then you will 
appreciate the book’s coverage of various device models 
{palm V vs. Palm VII vs. Handspring Visor), both wireline 
and wireless modems, and the wireless network 
(including proxy server) used by the Palm VII and 
Palm.Net service, 

I was pleasantly surprised at the consistency of the 
presentation, considering that there are four authors listed 
on the cover. Either one person did the lion’s share of the 
writing, or the editor(s) took the time to make sure the 
individual styles meshed well. 

There were a few grammatical oddities lhai I didn't catch 
on my initial read, such as missing words (“as*, “the*), but 
they were infrequent enough so as to not mar the reading 
experience. 

What's different about this book? 

For starters, there is an entire chapter on debugging 
WCAs, How often do you find dial in a programming 
book? Not often enough. 

The book includes a chapter on integrating WCAs with 
other applications on Palm devices, including launching other 
applications. There is also an entire chapter devoted to 
INeiLib (the Internet Library), This last item is particularly 
useful because the amount of sample code freely available to 


Andrew Downs teaches programming courses at Tulane University College. You can reach him at andre wSdowns. ws. 
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INetlib developers w;is minimal (and may still be by the time 
you read this). 

Since this book concentrates on Web Clipping 
Applications (and not standard Palm applications), it wisely 
eliminates the typical chapter or two devoted to rehashing 
the standard Palm application skeleton. However, the hook 
d(Xfs include a discussion of modifying the application 
event loop for the purpose of watching for incoming data 
on a socket. 

What would be nice to have? 

Here are a few topics that are not covered, bur would 



New: PrimeBase 4.0 



make useful additions for a second edition: 

Net Lib examples. This topic is already covered in one 
other Palm OS book that J am aware of, but it would be 
useful to show the differences when using 1 Net Lib versus 
Net Lib, Why consider NetLib? Because it shipped for 
several years before INetUb. allowing your application to 
run on older devices and OS versions. 

Short Messaging Service (SMS), This is u telephony 
technology that was added to Palm OS 4.0. While not an 
absolute necessity for web apps, it adds the ability to 
actively send a small amount of data to or from a device, 
fi would make a nice notification feature when integrated 
with a WCA, 


Conclusion 

If you are involved in developing web-based Palm OS 
applications at this time, or are considering such a project, 
you need to read this b<K>k. 1 estimate it would have saved 
me forty hours of effort (searching the Palm developer web 
site, posting questions lo the mailing list, experimenting 
with APIs, etc.) over six months. Given its price of $49,95, 
this book should pay for itself almost immediately. Even if 
you are simply curious about the technology, having such 
a great amount of detail available in one resource is 
extremely convenient. 


Want to get press coverage of the 
product you’ve developed? 
MacTech news is the best source of 
technical news for everyone from 
Apple Developer Connection news to 
MacCentral to CNN. 

Just send your press release to 
press__refeases@mactech.com 
and if we can, well help 
you spread the word. 

User and productivity product 
announcements also welcome. 


Using PrimeBase, you are able to produce Internet 
and Intranet Applications faster and with the best 
performance ever. 

The development package includes the 

• PrimeBase Application Server 

• PrimeBase Development Framework 

• PrimeBase SQL Database Server 



)► www.primebase.com 


Develop on a Mac and deploy without any 
additional effort on any platform you want. 

• Completely cross-platform 

• Full-text searching and indexing 

• Object-oriented 

• Separation of code and layout 

• Native connectivity to any database 



PrimeBase 


SNAP Innovation GmbH 
Altonaer PoststraBe 9a 
D-22767 Hamburg / Germany 

www. p ri mebase .com 
e-mail: info@primebase.com 
Fon:++49(40) 30629-400 
Fax: ++49 (40) 30629-499 
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JAVA 

WORKSHOP 


By Andrew S. Downs 


Java Debugging Aids 


Stack traces, logging, and string searching 


lNTROTMOTON 

Many developers begin their debugging efforts very 
informally with a set of print statements that dump information to 
the console. That approach eventually leads to diminishing 
returns, and it becomes time to move Into the realm of the 
interactive debugger. Or is it? 

Sometimes the simplest tools are the liest. Interactive debuggers 
are wonderful but they invariably require a developer to sfx.-nd 
substantial time in several areas: learning how to use the product 
and if ten applying that knowledge during a debugging scission. 

Arguably the most useful tilings that interactive debuggers 
provide are stick traces and variable and register values. If you 
know where the program is currently executing and the current 
program slate, you ean often figure out how to proceed in locating 
the source of a I mg. 

Somewhere in-between the println calls and setting of 
conditional breakpoints ad museum lies a middle ground. 
Determining how the program reached a certain point during 
execution can lie done with a stack trace, which is very easy to 
generate from a Java exception. Since exceptions can lie generated 
(thrown) and immediately caught, they do not need to cause the 
program to stop running. Ik'ing able to send that information, along 
with program state data, to a file or to the console allows you to run 
the app for awhile and follow the execution, then evaluate the data 
later when determining how to find and fix a bug, 

This article discusses several Java utility classes that may prove 
useful in your debugging efforts. The Erst class is a simple .stack trace 
generator that can wriLe its output to a file or the screen. The second 
two are file writer classes. The fourth class contains example 
methods that make string searches easier. 

By themselves these classes will not find bugs, but they 
provide information to use as a starting poini in determining what 
to try next or where to look when problems arise. They are 
invasive in that you need to insert calls into your code (which can 
be conditionally wrapped), but they provide more details than 


the typical print statement, so hopefully you will find the reward 
worth the extra effort 


StackTkau- 

The first listing contains the Stack! race class. There are three 
ty;x i s of methods here: constructors, file writers, and toString( > 
overloads, 'the class works by taking an existing or new exception 
object, and printing out the stack trace. This has the effect of 
generating a stack trace at any kxiaion in your program, which is 
very' useful for following the flow of execution. Sending the output 
to a file is often the most useful, and if you can easily locale certain 
entries in the file you will tx 1 much happier. Several of the methods 
in this class accept a lalxd to accompany the trace information. 


Listing 1: SlackTrace.java 

Sudftbcc 

Generate jl suck trace. Optionally xml the text representation had to the caller, write it to a 
file, :uxl/or include a labd 2 nd tmuxnmp. 

publie class StaekTrace I 

// Use the native system ddimker instead ofhaidcndcd newlines 
private static String lineSep = 

System.geiProperty( H Iine.Reparalor"): 

//Tlx default output file, which can he overridden by using uncof the cmsmictors. 
private static String filename = “StackTraceLog. txt H : 

//The source of the stack trace. 

Exception exceptionObject: 

// In tile empty constructor throw and olch the exception. 

// It keeps die callers code Uirly dem 

StackTracef) [ 
try I 

throw now Exee ption 0: 

\ 

catch {Exception e) I 
exceptionGbject “ e; 
write{filename. this.except lotiObjett); 

I 

I 

//This constructor alkws the caller to specify Lk* output filename, it also generates an 
// exaction for the caller. 

SUckTrace (String file path) I 
try f 

throw new Exceptfon(): 


Andrew Inis worked with Java .since 1996. Most recently he worked on the java desktop client and enterprise servlets for Snippets Software. You can 
reach him at andrew@downs, ws. 
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I 

catch {Exception e) I 

pjcceptiOfjQbject - e; 

write(filepath. this.exceptionObjoct)■ 

1 

1 


//This consmxior aJk>ws thr calfcf It) specify the output filename anti a previously 
// created exception 

StackTrace(String filepalh, Exception e) \ 
write(filepath, e); 

I 

//Ibis constructor rakes an atkljtkmal string that is printed bdba 1 the stack trace 
// Use il to put a label on a particular trace in the Ole. 

Stack!race(String filepuih. Exception e, String s) [ 
write(fiiepath T e. s); 

1 

// Litis constructor trims the trace to a specified number of lines before writing, 

StackTraeeUrn i) t 
try t 

throw new KxueptionO: 

I 

catch (Exception e) I 
except!onObject - e; 
write (filename, toStringte. i)): 

1 


//Write to Ilk 

public void write(String Hlepath* Exception e) ( 
wrlteCfilepath. e. null); 

) 

//Write to tUr timestamp the entry' and include an optional siring 

public void write (St ring filepath* Exception e. 

String aj ( 

try t 

java.io.FileWriter f - 

new ]ava.ici,FileWriter(niepath, true): 

£*write({new java.util.DateO).toStringO + IlnuSap): 

if ((« 1= null) && (s.length{) > 0)) 
f.writeU + linoSep): 

e. printStackTraee(new java.lo.PrintWriter(f T true)): 

f. write(lineSep); 
f. riuishf): 

f.closet)i 

I 

catch (java.io.IQExccptIan ee) ( 

I 

finally I 

\ 


//Write to file. indodiOK a timestamp 

public void write(String filepath. String s} I 
try ( 

java,io,FileWriter f " 

new java.io.FiieWriter (filepath* true): 

f.write((new java.util.Date0).toStringO + lineSep): 

if [{s I- null) U (a.length () > G>) 
f.wrilets + lineSep): 

f .flushO : 

£.close0: 

I 

catch (java.io.lOException ee) I 
1 

finally ( 

1 


//The requisite wcrrldc.This allows easy onscreen display by the cuIRt 

public String toStringO I 
String retval * 

* T <SrackTrace Exception attribute is null>~: 

if (this.exceptlonObject != null) 

retval - toSirlng(thfa.exceptionObject): 
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return retvai: 

I 

//A stallc toStringO overbad far coovtnkricc.lTiis gives the caller^one^op 
// shopping! bm they have to generate die exception themselves, 
public static String toString(Exception e) f 
java,io,ByteArrayOutputStream h - 

new java..io.ByteArrayOutputSLream(1024J; 

e.printstackTraoe[now java,ics.FrintWriter(b. true)]: 
return b.toStrltjgC): 

1 

//A static ToStringO overload dial limits the number of lines returned, 
public static String toString (Exception e, int nuntLines) 

java.io.ByteArrayOutputStream b = 

new java.io.B^eArrayGutptttStream(1024): 

e.prlntStackTraeeUiew java.io.PrintWriter(b. true)); 
String s = b.toString(] ; 

StringBuffer sb " new StlingBuffer(s,length0): 

java,util.StringTokenizcr si = 

new java.utiLStrlngTokenizerCs. lineSep. false]; 

int count - 0: 

while (st.hasMoreEl entente 0) [ 
sb, append (st. naxtE lenient {)); 
sb.append[lineSep]; 

count++* 

if (count >- numLines) 
break; 


return sb, toStringO ; 


LogFiii: 

Hi is class uses random access files rather than streams. The first 
method writes a string to a tile, and the second returns the contents 
of a newline-deliiniled file to l he caller 


System,out.printIn(msg + 

Sys -tern.getProperty(“line,separator*)); 


public static String contents() I 
String retvai = 

try S 

HandomAccessFile raf = 

new RandomAccessFile (mFi lenarne, “rw 1 *'); 

long length = raf, length0; 

raf.seek£ 0) ; 

long i - 0; 

String s - 

StringBuffer sb - new StrlngRuffcr(); 

if (sb != null) [ 
while (i < length] I 
f. - raf. readLine (}: 

if (s I- null) I 
i += S.lengthO ; 
sb.append(s): 

I 

else 

break; 

1 

retvai = sb. toStringO; 


raf.close(); 

\ 

catch [TQKxceptitm e) I 

System, oil l.println("10Exception reading logfile" + 
System.getProperty(“line.separator")): 

catch (Nu1IFointerExtoption e) f 

Systern.out.prlnrln( M NullFoiuterException reading" + 

“ logfile" + System.getProperty("line.separator")); 


return retvai: 


listing 2 : LogFile.java 

Write a hiring to a lile.ddctca fiMnd rcnim ihc content of a file. 

import java.ja,*; 
import java.util.‘; 

public class LogFile I 

protected static final String taFilenarae *■ "log.txt"; 
protected static final boolean milseTimestamp - true; 

public static void log(String mag) I 
try I 

RandomAccessFile raf -* 

new Rand omAc c e s s Fi1e(mFi1 ona me ( "rw"): 


FujeUtils 

This listing contains iwo methods: the fiist writes a suing to a 
file, the second writes a stream of bytes. There Is nothing fancy here: 
these convenience methods simply wrap the sometimes 
ctimheffiome sequence of calls that setup, write, and close files. Note 
that both of these methods first delete the file if It exists. This is less 
useful for a logfile, where you want to retain history, but if you are 
replacing an existing data file with a downloaded version, then it 
makes sense to first remove the original file. 

listing 3: FileUUls.javii 


raf.seek(raf. 1ength()); 

if (niUscTi.mest amp] I 
Date d ~ new DateO ; 
raf.writeBytes(d.toStringO + "; n +■ 
System.getPropertyl"]inc,scparuLor")): 

raf,writeBytes(msg +■ 

System, get: Property ("line, separator")); 

raf.close{); 

I 

catch (lOException e) 1 

// file error? Write to the console instead 


mUtjOn 

Wrile a string or byte stream to a fik.Thc byte stream Is useful when dealing with binary 
(nontext) data. 


import java.io,*; 


public class Filelftiis [ 

public static void vrlteFTletString 
String file) [ 

try | 

File f " new File (path + file],; 


a * 


String path. 


// Deleting die file is appropriate if we arc replacing oid data wirli new data. 

if (f.existsO) f 
f,delete 0: 

f * new Fil«(patfo + file): 
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Fi 1 eQu t pu t S t r eatn fos “ new FileOutputStream(f); 
DutputStreaiaWriter w = new OutpuLSLreanWriterffos] ; 

w.writets. 0. b. lengthU? • 
w.close(); 
fos,closet); 

* 

catch (lOException e) I 

System.out.println(“IQException writing string.*): 


public static void writeFileBytes[byte sf], int start. 
String path. String file) I 


try I 

File f = new FileCpath + file): 


if (f.existed) ( 
f .deleted : 

£ - new File(path + file): 

1 


FileOutputStream foe = new FileOutputStream(f); 

// Buffered streams often provide better performance than their non-I offered 
// countctpa/ts, 

RufferedQulputStream w = 

new BufferedOutputStreain(fos): 

//'llu; start value c useful when writing the file in pieces (eg. lots of data). 

v. write(s, start, a.length start); 

w. close 0 ; 

fos,closed; 

1 

catch (lOException e) f 

System,out.printIn(“lOException writing bytes."): 

I 

I 


SlHlNGirilLS 

'Hie ability ro locate substrings is one or the best things alxxii 
die java.kmg.Si ring class. The problem is that often you want to do 
more than simply locate a siring: you may want to trim portions of 
it at the same time. The methods presented here wrap the standard 
search and replace functionality. The first method locates and 
returns a substring. The second locates and remrns multiple 
occurrences of the .search string. The third method is similar to the 
second, but it trims starting at the location of a substring within the 
found string (such as finding attributes within an HTML tag). Hie last 
method replaces a substring. 

Each of these methods receives arguments that allow you Lo 
specify whetlier to locate and include a second string in the returned 
result. For example, if you are parsing HTML lags this allows you to 
remove die final >' from the returned string. In many situations a 
simpler set of methods (with fewer options) will suffice. 


Listing 4: StringlftiKjava 


String! Jtils 

Various string search anti replace methods. 

Import java,util,*; 

public class StringUtila I 

public static String find Substring (String buffer. 

String open. String close, boolean includeFront. 
boolean Jncl.udeBack) ( 

String ref = null; 

int start = buffer.indexOf(open, 0); 
int end - buffer.indexOf(close. start): 


if (start >= 0 && end >- 0 && end > start) t 

// nils complicated set of conditionals checks each combi nation for tujiKjving 
// the open and close .strings from the result. 

if (IincludeFront) i 
if (lIncludeBack) 

cel = buffer.substring(start + 

□pen.length(), end): 

else 

ref - buffer.substring[start + 

open.length(), end + close.length()); 

else I 

If (!includeEuck} 

ref = buffer.substring(start, end): 
else 

ref = buffer.substring(start, end + 
close.length0); 

1 

} 

return ref: 


public static Vector findStringGccurrences(String buffer, 
String open* String close, boolean 1 ncludcOpcn. 
boolean includedlose) I 
Vector v 3 new VectorO; 

int fromlndex - 0: 
boolean found = true: 

String ref: 

//Hie is similar to the one-shot findSuh$tring() method above, 

// Note the adtkri loop that ensures we cateh all oecurmKes of the sul^tring 
// in the entire string 

while (found && froraIndex < buffer.length0) ! 
int start ~ buffer. indexOf (open* froaltidex); 
int end = buffer.indexOf(clone, start + 
open.length(]); 

if (start y~ 0 hh end >= 0 && end > start) I 
<snip> 

//The if-dsc block from fitjdSufestriflgQ ahow hoc. 

// the fogic is the sintc, 

//Ilk vector will contain the ckCUtrunm of the substring. 

v.addElefnert (ref. toSttlngO ): 

//1 tptLirc the search starting point. 
f romlntlex = start + 1: 

I 

else 

found m false; 

1 

return v; 


public static Vector findStringOccurrences(String buffer. 
String open* String offsetString, String close, 
boolean includeFront) I 
Vector v * new Vector(); 

int fromJndex - 0; 
boolean found = true; 

String ref; 

open - Qpen*totlpperCa£e(); 
offsetstring = off&etString.toUpperCaseO; 
close - close, tolfpperCase 0: 

String searchstring - new String (buffer); 
searchstring = searchstring, toll ppe rCase 0 j 

while (found && fromlndex < buffet.length()) [ 

int start = searchString.indexOf(open, fromlndex]; 
int end “ searchString,1engrh(); 

//1 jncate a substring (oflklSrring) within the found string, 

// Note iltit this adjusts the stall value for the substring optralion 

sLart = searchString.IndexOf(offsetstring, 
start + opetuiengfhO): 
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if (close.length0 > (3) 

end - searchstring.indexOf(close, 
start + offsetString. length {)}: 

if (start >” D && end >= 0 bb end > start) I 
//The k)gR ts simpler in this method since we do nt)i look for i 
// cfcriqg string. 

if (lincludeFront) 

ref = buffer,substring(start + 
offsetString,length 0. end): 

else 

ref * buffer.nubstringtstart. end); 
v.addElenieiit (ref) : 

| tromlndex = start + 1 ; 

else 

found ■ false; 

) 

return v; 


public static String replaceString<3ccurrence( 

String buffer. String replacement. String open, 

String close, int occurrence, boolean inclndeFront) l 
St rlngBuffer sb w now St r LngBuffer(); 

int fromindex “ 0; 
boolean found * true; 

//W.Uk dtfuugh Jk- attire hutfcr looking fur the Kii uccunoKt' of Uu; 

// string (the variable named open), 
while (found) [ 

Int start " buffer.indexOf(open, fromlndex); 
int end * buffer.indexOf(close, Start + 
open,length()); 

if (start >- 0 && end >- D && end > start) ( 
fromlndcx - start I 1; 

occurrence-; 

// Once the count readies »iw, we have located 
// tlx starling |xhiiI lor the rcptaxnxnt ojx-ralkjn 

if (occurrence > €) 
continue: 

//Assemble- the string Ihim frnni to hack. 

// This call tun also he used to simply insert the replacement string by 
// setting ircludcFmnr m tnr. 

if (includeFront) 

sb. append (buffer, substring^. start + 
open.length(V)); 

else 

sb. append (buffer, substring^. start)); 

ab, append(replacement): 

sb,append(buffer.subst ri ngfond}): 

break: 

I 

else 

found “ false; 

I 

return sb.toSiringO; 


CONOIISJON 

The classes anti methods presented here should make your 
logging and deixtgging efforts a little easier for those times when 
you do not require an intimate session with the debugger. The 
methods can lx j used to help determine starling points for more 
detailed debugging efforts. 
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PROGRAMMING 
IN COCOA 


By Dan Wood, Alameda CA 


CURLHandle 


A Feature-Rich Cocoa Class for 
Fetching URLs 

Overview 

Cocoa developers who have made: any effort to support 
URLs in their application—for example, to fetch a resource 
from a Wei) or FIT site—have no doubt encountered NSURL 
and NSURLMandle, foundation classes for URL retrieval. 
NSURL is a class that wraps around any URL (as specified in 
RFCs 1808 and 1738, not that you need to know) and allows 
access to the individual components, such as the host, the 
port, and the scheme), ft provides rudimentary methods for 
fetching die contents of that URL NSUKLHandle is a more 
robust class Liiat represents the data associated with a URL, and 
it provides methods for foreground and I background loading of 
these data. But it doesn’t go far enough. This article 
introduces CURLHandle, an open-source class that you can use 
in your applications for even richer URL access* 

With NSURL and NSUKLHandle, you can create a full- 
featured application that can letch files via ftp:// URLs, Web 
based data via http:// URLs, or local files wrapped in file// 
URLs. But if you need more than what's provided in these 
classes, you may find yourself a long way from home. The 
NSUKLHandle class could use some additional features that 
Apple didn’t provide, such as: 

• Proxy support. If you have proxies configured in the System 
Preferences, NSURL! ia mile will not pay attention to those 
settings, and tail. You yourself may not use proxies, bur if 
you are writing an application for the general population, you 
will need to take this class of user into account In addition, 
you will probably want to supjxxt authenticated proxies, 
meaning tiiat an II) and password will need to lx* provided 
to access the proxy. 


• Tost” support. If you are attempting to fetch a Web 
page’s content via an HTTP POST rather than a GHT, you 
cannot accomplish this with NSUKLHandle. 

• Better access ro HTTP request and response headers. If 
yon wish to set a particular header in your HTIT request, 
such as the user agent, or you wish to process the header 
from the response, such as the content length, you are 
limited with NSUKLHandle. 

In creating Watson, 1 found lliaL 1 needed such abilities! 
Many Web sites that the program accesses need to lie POSTed 
to or have to have the request headers set. I also wanted to 
be able to show determinate progress bars as the pages load, 
and 1 couldn't do that without access to the headers to 
determine the transfer sizes. And if l had been using 
NSUKLHandle, l would not have been able support users 
working behind a proxy server But where to turn? 

CURL Has These Abiiities 

CURL, an open-source utility by Daniel S ten berg t is a 
great tool for accessing URLs. Apple includes the curl 
command line tool with Mac OS X (version 10* *1 and 
greater), so you can fetch web resources via the command 
line. It is indispensable for shell scripts or just quick 
fetching of a resource via I TP. Kor instance, you might 
download Omni Dictionary with the following command: 

curl 0 ftp://ftp . oinni group, cam/pub/tJO ft Wrtrp/ 

MocGSX/10*1/OmniDictionary - 2 ,0.1.dmg 

CUR I/s functionality is available both as this command¬ 
line utility, and as a library of C functions, called libcurl, 
which must be downloaded separately from CURL’s home 
page at httpi//curLhaxx*se/. libcurl is a full programmatic 
interface to the functionality in CURL. There are simple C 
functions for setting up the transfer, for performing it, for 


Dan Wood has been programming on the Mac since die days of black and white screens, in various languages and frameworks. His latest creation is Watson, 
an application written in Cocoa, You can reach him at d wtxxJ@LtreLt.com. Dan thanks John C. Randolph for a Lectinkai review of this article. 
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processing the data as ii is received, and for getting 
information about the transfer after the fact. 

CURL is a particularly attractive tool because its license is 
quite permissive; it can be used in commercial distributions 
without any hassles. 

C, Meet Objective C 

Writing pure C code in the middle of an Objective C 
Cocoa application is possible, except that you have to stop 
thinking in terms of objects and start thinking in terms of 
pointers, structures, threads, and callbacks. This is not any 
fun for a spoiled Cocoa programmer! Fortunately, somebody 
{dial would lx? me) has “taken the hit" and wrapped lilx-url 
in an Ohjective-C class for you, so you don't have to. 
Nevertheless, ids a good learning exercise to understand how 
tins works, as it brings up issues of memory management, 
tit reading, ports, notification, and caching. So let's go over 
hosv this was done. 

Subclassing NSURLHandle 

CURLHandie \s a subclass of NSURLHandle- The 
NSURLHandle class provides some of the functionality that 
w t c want to inherit, and a lot of structure. Actually, 
NSURLHandle is a somewhat abstract class, with hidden 
subclasses doing ihe real work behind the scenes. (See 
http://devdo[KT.applex’oni/techpubs/macosx/Cocoa/Task.sA 
nd Co nee \ s/P n >gra mm i ng I < >p i c$/Fot indat io n/Cc >n cepts/ 1 Cl a ss 
Clusters,hi ml for a discussion of “Class Clusters.") hi essence, 
NSURLHandle provides an interface to conform to, the 
advantage being interoperability with other Cocoa classes, fn 
fact, you can configure your program to use CURLHandie 
instead of NSURLHandle globally using the 
curiHelloSignaLurtvacceptAll: class method by passing in a 
YES as the second parameter. 

The documental ion for NSURLHandle provides hints for 
how to sulxiass it. (It probably wasn’t intended to lx 
subclassed to handle protocols such as FTP and HTTP, since 
it handles that already. But there's no reason not to, either.) 
One challenge in building CURLHandie was that the source 
code to NSURLHandle, like all of Cocoa, is noi available to 
the public. Anybody who has tried to sulxiass an non-trivia I 
abject for which they do not have the source code is 
probably aware that this can be tricky! Methods in the base 
class interact with other methods in ways that are not 
documented; it’s not always dear (especially in a language 
such as Objective C without “public" vs. “protected" 
methods) when a public method is or is not meant to lx 
overridden (and whether the superclass behavior should be 
inherited lx fore or after the override or not at all). So 
subclassing an opaque class requires a lot of good 
documentation (which has been lacking in much of Cocoa) 
and a bit of trial and error. OK. a lot of trial and error! 


Callbacks 

The architecture of Ubcurl is such that before the transfer 
is to take place, the options for what to do wiLh the incoming 
data are set, in the form of a C callback, as follows: 

Curl_easy_setopt (tnCURL ♦ CURI,OPT_WRITEFUNCTION* 
curlBodyFunction); 


The lilxurl API indicates that the buffer is passer! into the 
callback as a void *. When the transfer is invoked, the 
callback is invoked multiple times as chunks of data come in, 

size_t function ( void ‘pLr, size, 

size t tmetnb, 

void ^stream): 


To wrap this in a class, it makes sense to minimize the 
amount of pure C, and jump back into Objective C from the 
C callback as quickly as possible, so we can update the GUI 
(in the foreground thread) and perform other operations 
from familiar object-oriented methods. To accomplish Lhis, I 
pass a reference to the CURLHandie object as the inSelf 
buffer parameter. inSelf is cast buck to a CURLHandie object 
and the Objective C syntax takes care of the rest. This way, 
the entire functionality of the callback, except for this little 
stub, is written in Objective C. 


Si£e_t curlBodyi’unctiun( 

void *ptr* size_t aize, aiac_t nmemfa• void 
*inSelf) 


I 


return [(CURLHandie *)inSelf 
CtitrlWritePl t: pt r size: size 

number:nmemb message:BODY]: 


I 


Foreground Ixiading 

Loading a URL in the foreground thread is perfectly fine 
for a file:// URL, and is possible — but not a good idea—for 
a remote URL, since you don't want your app to have to wait 
for data from the remote host. Still, it can lx done if you and 
your users won't mind a “spinning rainbow" cursor. 

Foreground loading is very straightforward; 
[NSURLHandle loudlnForeground] is overridden to call the 
lihcurl method curl_easy_perfonn. What differs from the 
standard NSURLHandle foreground loading is that it's 
passible to specify an indeterminate progress bar Lo animate 
while the data is coming through. Each time the curiWritePtr: 
callback is invoked from a foreground load, the animate 
message is sent to the attached NSProgresslndtcator object. 


Threading 

To really make a program useable, a program should 
load network URLs in a background thread, so that the 
foreground will still be responsive. 

Threading, on any platform or language, is not trivial. 
Cocoa has some techniques to shield you from some of the 
intracacies of threading by using a callback-like mechanism, 
working in conjunction with the event loop that covers simple 
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cases of multithreading. An application can, for example, start 
a URL loading in the background and then respond to 
messages—treated much the same as user events—generated 
by a Ixtckground thread. A client of an NSURLlIandle or a 
CURU landle (implementing the NSURLHandleCliem protocol) 
just implements methods to react to progress [trading; these 
are invoked in the foreground thread even though die loading 
is taking place in die background 

To create this illusion of simplicity, CURLHandle has to 
do actual threading- Cocoa provides some classes that 
wrap Mach threads; but there are always subtleties to be 
nailed down. My goal was to initiate a background load in 
a new thread bur be notified in the foreground thread as 
the load progresses so that the user interface can be 
updated or the load stopped. Thus, the background thread 
needs to send messages to the foreground thread. 

For CURLHandle, l make use of several classes; 
NSThread, NS Run Loop, NSPort, and NSPortMessage. I 
haven't found a need for any of the locking classes, and I 
chose noi to use the more sophisticated Distributed Object 
methods that were a bit overkill in light of the very simple 
messaging needed here¬ 
in the initialization of each CURLHandle, I store a 
reference to the current thread, so that during a load, when 
a callback needs to find out if it is running in the main thread 
or not, it can just compare the current thread to that 
reference. I also store a reference to the current NSPort, 
which is used as the sending and receiving port for the 
messages from the background thread to the foreground 
thread. 1 set ihc delegate of that port to be the CURLHandle 
object itself, so that it will handle messages sent to that port, 
Finally, I add that port to the Run Loop, meaning that when 
the application is processing events, this port will be a valid 
receiver of messages. These messages will be received as [lie 
foreground thread waiLs for and processes events, 

mMainThread = f [NSTb re-ad current Thread J 
retainl; 

tnPort * [ [NS Pori port] retain!; 
fniport solDelegate:self J ; 
t[NSRunLoop correntRunLoop] addPort;mPort 
forHode:NSDefaultRunLoopMode]; 

To actually begin a background load, a new thread is 
detached in the override of lieginLoadlnBackground. This 
causes the method curlThreadBackgroundLoad: to be sent to 
self in the new thread. 

LNSThread deta^hNewThr^adSelector; 

Fcror (eurlThreadBackgroundLoad;) 
toTargot:actf withObject:nil]; 

In the new thread, curflhreadBackgroundLoud; invokes die 
cud_easy_perfomi C function to actually invoke the transfer. 
Periodically, when data arrives, the oirlHeaderFunction and 
curl Body Function are invoked, as deserilxxl alx>vc\ These 
wrappers invoke their Objective-^ counterpart, 
curlWriteJ ? tr:size:numl>eraT]essage;, in order append the data to 
the data buffer, and update tile user interface. 


If this method determines that it is not running in the 
foreground thread, it constructs an NSPortMessage to send 
to rhe port. This message is sent from and to the NSPort we 
saved earlier. The port is given a numerical message 
(which we define in code to represent "done loading,” 
“loading failure/ “header data," or “body data"), and then 
the message is sent (with a timeout value of 60 seconds, 
meaning that it will attempt lo send the message for 60 
seconds before giving up). 

NSPortMessage ^message 

= t[NSPortMessage alloc] 

InitWithSendPort:mPort 

recelvePort;mPort 
components:dataArray] : 

[message seLM&gid:inMessageIBj; 
sent = [message sendBeforeDate:[NSDate 
dateWithTimeIntervalSineeNow:60.011; 

After die load is finished in the background thread, a 
final message is sent to the foreground, indicating that the 
load is finished, and then the thread exits. 

While the thread is executing in the background, the 
foreground thread should Ise idling, waiting for user inputs 
and messages in the port we created. When a message is 
sent from the background, the handlePortMessage; method is 
invoked in our class. We use a simple switch statement to 
process the numerical message ami handle the cases of a 
completed load, an error in loading, or new header or body 
data, (Again, distributed objects would be handy here if the 
communications model go! any more complex than this-) A 
typical handling of such a message would be to invoke the 
NSl FRLHandle method that is lie used as data is loaded - 
[NSURLHandle didLoad Bytes: loadCompleted The client that 
is paying attention to the URL Handle could then update a 
progress bar to show that the data is coining in. 

Cancelling Loads 

Cancelling a load is simpler than it might seem. Rather 
than irytng to have the foreground thread literally send a 
message to the background thread to stop the load, we just 
set a simple flag that will signal libeurl to abort a load the 
next time it invokes the callback. In other words, we just 
leave a message lo cancel the toad that the background 
thread will be checking for each Lime through. 

Thus, we override -[NSURLHandlc 

c'ancelLoadinBackgroundl to set the m Abort Background field 
Of the CURLhandle to YES, And in our callback (or rather, in 
the Objective-C method that our callback invokes), we just 
check for the state of that field If it is set, then we return a 
value of -I, which will indicate to libeurl I hat rhe toad has 
l^een cancelled. 

Memory Management 

Dealing with memory is simple in Cocoa once you get 
the hang of it, knowing that you must retain anything you 
want lo keep around, and that you can autorelease any 
object that you just need for the duration of the processing 
you are doing. But in order to combine tills Object-based 
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memory model with the raw malloe-style memory blocks 
needed for libcurl, a few interesting design decisions had to 
be made. 

To set an a loading option in libcurl before the transfer 
takes place, you typically use curl_easy_setopt with a C 
string as a parameter The method -iNSString cStringl returns 
a pointer to a C string that is effectively autorelease’d. So at 
first glance, it would seem that you could just wrap a lilxurl 
function in a higher-level function that takes an NSString as 
a parameter and converts it to the C string. 

Not so fast. This doesn't quite do the right tiling for 
background loads. When you set your options, and then 
begin loading in the background, Lite method that you used 
to set these options will finish, and then the run loop will 
clean up the "autoretease" pool. This means that the 
memory that had t>een temporarily allocated For these strings 
will lie deallocated, even though libcurl is, in the background 
thread, still trying to make use of that memory! 

So instead, we store the options that we want in an 
NSDictionary attached to the CURLHandle object, as shown 
in Listing l. Then in the background thread, right before the 
load actually commences, we grab all these options from the 
dictionary and set the libcurl options. Tins way, the memory 
stays around while we still need it, and wc don’t have to 
remember to explicitly deallocate anything. Problem solved. 

Listing It CURLIIandle.m (fragment) 

setStringtforKey 

Si ore the given string its on option for the toad 

(void] setString:(NSString *JinString 
forKey: (CJURLoptlon) inCurlOption 

( 

ImStriitROptionfl setOhject: inStrtng 

forKey;[NSNumhnr numberVithliu :inCur 1 Option] ]; 


prvpa rv Ai idl Vrft 1 u rl 

Just before the transfer commences, grab die entries from the saved 
dictionary and set these as options for the transfer 

- (void) prepareAndPerforinCurl 
I 

struct curl slist •httpFeadcrs = nil; 

NSEnumerator *th<?Enum - [mSLringOptioTis 
ReyEnumerator]; 

NSString HheKey; 

while (nil 1" (theftey - ItheEnum next Object]) J 
I 

NSString 'theString 

- [mStringOptianB abjectForKey:theKey]; 
mResult = mr1_casy_seLopt ( 

mClfRL* [theKey intValue]. [theStrlng cStringl): 
if (0 t= mKesult) 

I 

return; 

1 

I 

// ... Now perform die transfer with curl_casy_pcrform .. (not shown 
here) 

\ 


CACHE MAN AtrHM ENT AND VISUALIZATION 

The NSURLIIandle specification allows you to cache 
your handles and their contents; this is convenient when you 


might be retrieving the same resources multiple times and 
don’t want to perform redundant transfers. CURLHandle 
employs a very simple caching mechanism, by just 
remembering everything you cached while the application is 
running (although it could lie modified for a more 
sophisticated '"Least Recently Used" mechanism). There are 
a few additional methods not provided in NSURLHandlc, 
however, for clearing out the cache and for visualizing the 
contents of the cache. 

The cache is implemented as a simple 
NSMutahleDinionary. The key for each entry is a URL; the 
value of is the CURLHandle object, which contains the data 
that was loaded. 

When writing an application that uses CURLHandle, you 
may find it helpful to he able to “see" the contents of the 
cache while the application runs. To aid visualization, 
CURLHandle posts notifications 

(ClJRLHandleCacheCreate Notification, 
CURLHandleCachcDeleteNotificatlon, and 

CURLHandleCacheChangeNotification) when the cache is 
changed 

Why is this of any use? You can build debugging code 
in your application that listens to these notifications, and 
updates a display of the contents of that cache, tn (his 
example, I use an NSTableView (with a single column) to 
display each of the URL kc-ys in the cache. 

This technique, by the way, is handy across a wide 
variety of applications. If you have a data structure in 
memory that you would like to be able to visualize while 
a program is running, just write a simple class that mirrors 
its contents in a table view, and build a nib file with a 
window and a table. You will save quite a bit of 
debugging time if you can glance at your internal states 
rather than relying on logging or breakpoints. Listings 2 
and 3 show the controller object for a window that 
displays the cache. 

Listing 2: DebugCurlController.h 

^Import <Cocoa/Coeoa- 10 

^inLerface DebugCurlController ; NSObject 
( 

IBGutlet NSTableViev •©Tables 

NSDictionary ‘rnTrackingnache: 


Listing 3: DebugCurlControllenm 

//import “DebugCur 1 Control ler,h" 

I! import "CURLHandle . h” 

$ i mp 1 omen ta tion UebugCuriCont rol1e r 


awakeFmmNlh 

When ihe nib file is finished loading and all the anion* and outlets ate 
connected, subscribe to notifications of the cache being changed. 

- (void) awakeFromNib 
i 

[[NSNotificatlonCenter defauitCenter] 
addObserver: self 

selector:^selector(dpdateCURLHandleCache:) 
name:CURLHandleCacheChangeKotifleation 
objectitiill : 

1 
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dealloc 

When this object is deallocated, release our reference lo the cache, .md stop 
Listening Tor notifications. 

- (void) dealloc 
I 

fmTrack.1 ngCache release]: 
r [NSNotificationCenter defaultCenter] 
removeObserver:self]; 

[super dealloc]: 

] 


updated JRLHandieCache: 

Respond to a notification that the cache has changed. Get the associated 
object (the cache itself) Lf we don't have it yet, and then tell the table to 
redisplay itself. 

(void) updateCURLHandleCache: 

(NSNotification * *)inKotification 

\ 

if (nil = mTrackingCache) 
l 

mTrackingCache = [[inNotification object] retain]; 

[oTabie reloadData]; 

J 


mimberOfRowsl nTa blcView; 

Return the row count, which is just the count of items in the cache. 

■ (in t )nu mbe r0 fftowsInTab1eView: (NSTableView 

*)inTableView 
[ 

return [mTrackingCac.be count]; 


table View: oh ject Va I ueForTa blcColuom:itt w : 

Return a value to place in Lhc given column/row of the given table.There is 
jnsi one column, so just return the URL associated with the nth key in the 
cache, 

(id)tablaView:(NSTableView *)inTableView 

objectValueforTableColumn:(NSTableColumn*)ini'ableColumn 
row: (ini) inflow 

t 

return I[mlrackingCachc allKeys] 
abjc a ctAtlndex:inRowl : 

) 

@end 


Extra Functionautv 

libcurl has 21 lot of pre-transfer options and jx>sl-lransfer 
queries. Most of them arc not central to the basic 
functionality of CURLHandle, In order to keep the 
implementation of CURLHandle as readable as possible, I've 
split the non-essential functions into a separate file and into 
a class category on CURLHandle. This file can be included 
in your application if the functions are needed, or it can lie 
left out. If you include the file, you have access to simple 
Cocoa methods for setting HTTP headers, cookies, timeout 
values, and querying transfer speeds and download sizes. 

Testing Application 

The CURLHandle package comes with a testing 
application, aptly named CURLLlandleTester (figure 1), 
that serves to put CURLHandle through its paces. It boasts 
a simple, geeky user interface that allows you to provide 
a URL to load and set a number of loading options, then 


invoke the transfer and examine its results. It takes full 
advantage of the CURLHandle (and NSURLHandle) 
interface, and provides examples on starting and stopping 
a transfer, monitoring progress with a progress bar, and 
viewing the headers and body of the transferred data. 
Like CURLHandle, the source code is freely available. 

0 0 CURLHandte Ttstfer 



figure L CURLHandleTesier in action. 


Opportunities for Expansion 

Although CURLHandle is exercised rigorously in Watson, 
there are features of libcurl lhaf have not yet been attempted. 
Use of cookies, FTP transfer, secure transfer, and so forth, are 
certainly possible with libcurl, but I haven't yet tested them 
myself. The open source nature of the CURLHandle project 
means that it should be easy for somebody with such needs 
to “hook ii up” and, hopefully, report Ltny fixes upstream so 
that we all can Ixmefit. 

Conclusion 

The goals for CURLHandle were to extend the basic 
functionality already available in NSURLHandle of accessing 
data via the 1HT P and FTP protocols, by adding the ability 
to work with proxies and be configurable for other needs 
such as HTTP Post, getting and setting cookies, accessing 
headers, and so forth. By wrapping around CURL, I was able 
to achieve this and have a foundation for more options. 

To get CURLHandle for yourself, go to 
http://curlhandle.sourceforgc.net/. The latest version is 
available there, along with plenty of documentation and 
the TURLHandleTester” project. Since this is open- 
source, It will continue to improve as more developers 
embrace and extend its capabilities. 


38 


CURLHandle 


MacTech * February 2002 


























Full 
Sourer 
Code . 


>A VL»nux. 


jV/Supporte 

o’//( p/ip 

*/.y \i)si*^| 


FairCoin* ^ 
Server SDK 


CUT YOUR 


Vertical 

Markets 


Library 

Management 


Embedded 

Hardware 


APPLICATION BENEFIT 


Internet Small 
Appliances footprint 

Medical Stable 
Devices 

Factory Includes Full 
Automation Source ( tide 

Space Proven 
Exploration Technology 


Corporate-Wi 
Applications 


APPLICATION BENEFIT 


akuu 


APPLICATION BENEFIT 


basy 

Deployment 


Ijegnl Flexible 
Licensing 

Insurance Huge F ile 
Support 

Inventory Scalable 
Control 

Point of Sale < ross 

Plot farm 


B2B Flexible 
Server Cnmiiiunicatiiiii 

Proprietary Fast 
Applications 

Dedicated Robust 
Web Server Threading 


C-TREE DELIVERS FAST, 
SOLID, AND FLEXIBLE 
DATABASE TECHNOLOGY 
WHILE CUTTING YOUR 


For over twenty years, FairCom's proven database technology has been a favorite of commercial developers for Macintosh applications ranging from low level embedded 
appliances to vertical market applications to huge multi-platform, corporate applications, FairCom has established this reputation by delivering uncompromising Standalone 
and Client/Scrver technology in a flexible package that enables you to cut costs while utilizing cutting edge technology like our new HUGE file support anti 64-bit support, 
FaiiCom offers this exceptional performance, unsurpassed data availability and rock solid reliability with a low total cost of ownership and flexible licensing options. 


Gel more for your development dollar ! Visit w wwJaimttnxom/ep/freecdoffer today 



Mao Support Since 1985 * www.faircom. 


Other cumpaiy ami prutkiii riWnM an? nEsgtSternd Q-ijCfcmflrks cr trademarta of llasr raafV¥cDve mimara 


a free developer's CD, 


FairCom 

Offices 

USA 

573,445,6833 

EUROPE 

+39,035.773.464 

JAPAN 

+81.59.229,7504 


BRAZIL +55.11.387251802 


• USA. 8D0.S34.Q180 • info@faircom.com 


O 2tca FarCam Corpandiort 















QUICKTIME 

TOOLKIT 


by Tim Monroe 


The Flash II: Revenge of the Trickster 


Using Wired .Actions with Flash Tracks 


Introduction 

Iri the previous QuickTime Toolkit article, we got a 
general overview of Macromedia's Flash multimedia 
development environment and saw some ways to work wiili 
Flash content inside of QuickTime applications, We learned 
that QuickTime i and later provide a Flash movie importer 
and a Flash media handler that allow us to import and 
display Flash movies as Flash tracks in QuickTime movies. 
We develop'd a simple parser that allows us to read through 
a Flash file to gel some useful information about the Flash 
movie contained in the file, such as whether it's an autoplay 
movie and whether the movie should be played full-screen. 
Finally, we got a taste for working with the public APIs 
provided by the Flash media handler. 

In this article, we're going to see how ro work with 
wired actions and Flash tracks. There are two general sorts of 
capabilities we want to explore here. First, we want to see 
how 10 embed wired actions in a Flash track, so that (for 
instance) clicking a button in the Flash track sends one or 
more wired actions to some other track in the QuickTime 
movie. Recall that QuickTime provides well over a hundred 
different wired actions, which can be targeted variously at 
sprite tracks, at individual sprites within sprite tracks, at 
QuickTime VR tracks, at hotspots within QuickTime VR 
tracks, at text tracks, at the QuickTime movie itself, and 
indeed at external movies and objects within those external 
movies. So it’s very useful to know how to trigger those 
actions with the interactive behaviors of the Flash track. 
Indeed, this ability is a necessity for the kind of Flash and 
QuickTime integration that is all the rage nowadays; using a 
Flash track and its panoply of interactive elements (buttons, 
menus, sliders, text boxes, and so forth) to control the 


operation of a QuickTime track. Figure 1 shows a simple 
example of using buttons in a Flash track to control the pan, 
tilt, and zoom parameters of a QuickTime VR movie. 



Figure /. A Flash lrack contmlling a QuickTime VR track 

The second way of using wired actions with Flush 
tracks Ls essentially the reverse of the first; instead of 
sending wired actions from a Flash track to some other kind 
of track, we might warn 10 send wired actions from other 
tracks to a Flash track. For instance, user actions in a 
QuickTime VR node (say, rolling the mouse over a hot 
spot) might trigger a wired action that tells a Flash track to 
create a new movie dip. In a simple case, the movie clip 
might lie a rectangle with some Lexl in it whose bottom 
right corner is anchored at the current mouse location. This 
would give a nice pop-up label (or "tool tips'*) capability to 
the QuickTime VR movie, as illustrated in Figure 2, 


Tim Monroe is a memlxr of the QuickTime engineering team. You can contact him ar monroe@apple.com. 
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Figure 2: A pop-up label provided by a Flash track 


In This article, weTe going to investigate these two 
techniques — embedding wired actions in Flash tracks and 
sending wired actions to Flash tracks. Our sample application 
once again is called QTFlash, and its Test menu is shown in 

Figure 3- 



Extract Flash Track... 

Zoom In 
Zoom Out 
Show All 

Odd Uliring To Button 

Figure 3; The Test menu of QTFlash 


specifies the percentage of the current movie window to 
zoom. This parameter is identical to the parameter passed to 
the FlashMediaSetZoom function (which we discussed in the 
previous article): to double the magnification, we pass a 
factor of 50. To halve the magnification, we pass a factor of 
200. If, instead of zooming in on the center of the Flash track, 
we want to zoom in on some other portion of the Flash track, 
we can use the kActionFfashlrackSetZoomRect action. This 
action needs four parameters, which are (in order) the left, 
top, right, and bottom of the rectangle to zoom. Once we're 
zoomed in on some portion of the Flash track, we can use 
the kActionFlashTrackSetPan action to pan it horizontally and 
vertically. This action takes two parameters, which (just as 
with the FI as h M ed iaSet Pa n function) specify the percentages 
of the movie window width and height to pan. 

The final two original Flash track wired actions set the 
current movie time to correspond to a particular frame in the 
Flash track (that is, Logo to that frame in the Flash track). The 
kActionFlashTrackGotoFrameNumber action jumps to the 
movie time that corresponds to the Flash track frame number 
specified in ihc single parameter atom in the action atom. 
The kActlonFlashTrackGotoFrameLabel action jumps to the 
movie time that corresponds to the Flash track frame whose 
frame label is specified in the single parameter atom; in this 
Case, the parameter atom contains a C string. 

QuickTime 5 introduced an updated Flash media handler 
(capable of handling Flash files up to version 4) along with 
two new wired actions: 

enUM I 

kActianFiashTrackSetFlashVariable = 1024b. 

kActionFiashlrackDoButtonActions “ 10246 

I; 

QuickTime 5 also added one new wired action operand: 

emitt l 

kOpermidFlashTrackVariable = 9216 

I: 


In the previous article we saw how to handle all of these 
menu items but the last one, which well focus on here. 

Wired Actions Targeted at Flash Tracks 

Let's begin by taking a look at the QuickTime wired 
actions that can be targeted at a Flash track. When the Flash 
media handler was first introduced, in QuickTime 4, five new 
wired actions were added: 

enum ( 

kAct i on¥l ashTrackSetPan 
kAc L ionFlastiTrackS et Zoom 
kAc LionFlashTrackSet ZoomKec t 
kAc t± qtiF 1 a s hTr ac kCotoF ram eN umb e r 
kActi onFiashTrackGotoFrarneLabel 

); 

The first three actions allow us to zoom in on a Flash 
track and to pan around inside a zoomed Flash track. The 
kActionFtashTrackSetZoom action lakes one parameter, which 


We can use the kActtonFlashTrackDoButtonActions action 
to execute the actions associated with a particular state 
transition for a button in a Flash track. (See the previous 
article for a discussion of button stale transitions.) This action 
takes three parameters, which specify the path to the button, 
the button ID, and the desired button state transition. We 
know how to specify a button state transition, using constants 
like kOverDownToQverUp ; which we encountered previously. 
The button ID is simply the character }D stored in the button 
data in the Flash file. The tricky part here is the button path . 
Objects in a Flash file arc arranged in a hierarchical structure, 
loginning with the root object, which is driven by the main 
timeline. T he root object can also contain movie clips, which 
(as we’ve seen) are essentially Flash movies embedded 
within Flash movies. Movie clips can be embedded within 
movie clips, to an arbitrarily deep level. 

To refer to an object in a Flash file, we must provide a 


= 10240. 

- 10241, 
= 10242, 

- 10243, 

“ 10244 


42 


The Flash II: Revenge or the Trickster 


MacTech • February 2002 


























Highest Security - 

Cross Platform: Mac OS 9 & X - Windows - Unix 
Support for C/C++, Pascal, Java, 4D and others 
Network and Local Support in Each Key 
Pay-Per-Use 

ESD - integration in eShops 
License Management 

User's Benefits: Data Encryption & Authenticatio 


HAWIMCJ V £ R 
13.-20 3 2002 
Hall 17 Booth CS2 
Hall 7 Booth C30-C2O 


if GRIFFIN 

^ .fECH'NULOGm, 


WlBU-SYSTEMS AG 

D 76T37 Karlsruhe 
WfB^SYSTEMS USA, Inc. 
Seattle, WA 98101 
email; 


USA, Canada: Griffin Technologies, LLC 
phone: (7$5) 832-2070 fax: (785)832*8787 
email: salesQgriftechxom* www. g riftech .com 


Order Your Test Kit 


Argentina nnfoW 4 afieM-t 3 rtnjp.com. Australia strrtoetj.edkerlG^wTbu.com, Belgium Nytbutfiropakt.btf. Croatia ddes^^rig^.iir, Denmark WbatWanbitdfc, 
Rniantf ifno.tiyt^Tii-iebyt^.co m. France nfc^ofrol.ff; Hrmgary ifrtoOmrs&ft.hij, Japan info^uncarla .co.ip, Jordan, Lobwoon 4 t*f 4 cift-®cybtrta-.o<ttJb r . 
Kurea dhkimmifhanmir.'C<>rii, NHhettemb 4 i?airirytfomf 4 ,nJ r Portugal tlubfii 0 clubiTj>t< Spain 4 e.m 0 sMiX.net, Syria- st 3 rsott@cybeH 0 .neMb, 
United Kingdom Info^codewc^.cpm, Uta.wli^griftecb.oPm 






SOFTWARE & DOCUMENT PROTECTION 





















path to that object. The button path specified as the first 
parameter to the kActionFtashTrackDoButtonActEons action 
must Ixj an absolute path Ixuginning wiLli the root object and 
containing the names of any movie clips the button is 
embedded within. In the simplest case, we can pass an 
empty path (that is, the string “*) to refer to the root object. 
If a button is contained in the movie clip whose name is 
“buttonClip”, we could pass the path VbuttonClip”. If the 
buttonClip movie clip contained yet another movie dip 
named "yellow", we could target a button in that second 
movie clip using the path "/buttonClip/yellow”. 

We can use the kActionFlashTrackSetFlashVariable 
wired action to set the value of a Flash variable in a Flash 
track, and we can use the kOperandFlashlrackVariable 
operand to get lhe value of a Flash variable. A Flash 
variable consists of two parts; a name and a value. The 
name is a string, and the value can be either a string or a 
number. To specify a variable, we need to provide its 
name and the path to the object it is attached to. (A 
variable can be attached to any object, including the root 
object,) The kActionFlashTrackSetFlashVariable action 
requires four parameter atoms: (!) the path ro the object 
to which the variable is attached, (2) the variable name, 
(3) the new variable value, and (4) a Boolean value that 
indicates whether ro change the focus to the object 
attached to the variable. 

Getting and setting Flash variables using wired actions is 
a simple and efficient way to establish interactions between 
Flash tracks and other QuickTime tracks that can he wired 
(currently, sprite, text, and QuickTime VR tracks). For 
instance, die hot spot in Figure 2 can he wired to trigger a 
k Action FlashTrackSetFlash Variable action ! hat sets some 
variable Lo a particular value; an ActionScript in the Flash 
track can then periodically test that variable to see which text 
box to pop up. 

Here’s a particularly nice trick with Flash variables: 
when you create a text box in a Flash movie, you can 
configure it as a dynamic text box , which displays text that 
can change dynamically (without lhe user having to type 
into the text box). A dynamic text box is automatically 
associated with a variable, which we specify in the Text 
Option panel (shown in Figure 4). 



Figure 4: The Text Options panel for a dynamic text box 
As you can see, the topmost pop-up menu sets the text 


box to be dynamic, and the name of the variable 
associated with the text box is set to H textVarT\ Now 
here’s the fun part: we can get and set the text displayed 
in the text box by getting and setting Lhe value of the 
variable textVarl. Listing 1 shows a simple function that 
builds an atom container with an event atom that changes 
the text to ^Caffe Macs” on a hot spot roll-over 

Listing Is Setting Flash text with a hot-spot rollover 

QTFbshCrcalcVirAction 

USE t r QT1TashjC reaL eVarAction (QTA t omContainsr 
* theActions) 

( 

QTAtom myActionAtom = 0: 
char myPath[I = 

char myVarName[] D "textVarI H ; 

char myVarValuef] - “Caffe Macs**; 

Boolean myFocus = false; 

OSErr myErr = noErr: 

myErr - QTNewAtomContainer(theActicns): 
if (myErr !*= noErr) 
goto bail : 

myErr = 

WiredUtils_AddQTEventAndActionAtoTns (‘"the Act ions , 

kParentAtomlsContainer, kQTEventMouseEnter, 
kActionFiashTrackSetFlashVariable, 
krnyActionAtom): 

if (myErr != noErr) 
goto bail; 

myErr “ WiredUtils_AddTrackTargetAtom( * theActipns . 
myActionAtom. kTargetTrackType, 

(void 1 )FlashMediaType, 1); 
if (myErr 1“ noErr) 
goto bail; 

myErr - WiredUri1s_AddActionParamelor Atom( r theActions, 
myActionAtoin. 1, strlen(myFath) + 1. my Path, 

NULL): 

if (myErr !* noErr) 
goto bail; 

myErr ~ WlredUtils, AddActionParamoterAiom(* LheActions . 
myAct i onAtrom* 2 , St rlen (myVarNanie) + 1* 
myVarName. 

NULL)r 

if (myErr noErr) 
goto baii; 

myErr - WiredlJtilsf Add Acti onPa r amo tor Atom (*t.heAc Cions, 
myActionAtom, 3, strI on(myVarValue) + I, 
myVarValue, 

NULL); 

if (myErr 1= noErr) 
goto bail: 

myErr - WiredUtiln AddAorionParameterAtom(“theAct i ons, 
myActionAtom* A. aizeof (myFor.ttF:) . kmyFocue. 

NULL): 
baii; 

return(myErr); 

\ 

QTFlash CreateVarAction uses a few of the wired action utility 
functions we developed in earlier articles to set the event and 
action types, to set Lhe target track (namely, to the first Flash 
track in the movie), and to set the four action parameters. It 
returns an atom container that can be inserted into the 
appropriate track. We don’t yet know how to wire 
QuickTime VR movies, however, so you'll have lo wail a bit 
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to lest tliis code uui or else attach it to a sprite or text object 
(which we have learned to wire). 

Wired Actions in Flash Tracks 

Let’s turn now to our second main task, learning how 
to insert wired actions into a Flash track. The basic idea is 
quite simple: we can add QuickTime wired actions Lo a 
Flash data stream (that is, the data in a Flash track or a 
Flash file) by adding an action of type saction Wired Actions 
to an action list in that stream. Recall that actions can be 
found in two locations in a Flash file: Cl) in the action list 
associated with a button state transition; and (2) in the 
action list associated with a tagged data block of type 
stag Do Act ion. Let's call these button actions and frame 
actions, respectively. A button action list is executed 
immediately when the specified state transition occurs. A 
frame action is executed immediately after the specified 
frame is rendered. For button actions and frame actions 
alike, we add a wired action by adding an action of type 
sactbnWi red Actions to the associated action list. The data 
in that action is simply an atom container that holds the 
appropriate event, action, target, and parameter atoms. 

It turns out, however, that this simple recipe is a tad 
complicated to actually implement* We need to parse 
through the Flash data stream to find the button or frame that 
we want to wire, and then we need to parse through the 
button data or frame data to find the assexiiated action list. 
Finally, we need to insert a new action into the list and then 
update all the relevant offsets and block sizes stored in the 
data stream. No one of these tasks is very complicated by 
itself, but accomplishing them all will occupy us for a while. 
For the moment, well focus on adding some wired actions 
to a button in a Flash track. The source code for QTFlash also 
shows how to add wired actions to a frame. 

Handling the Menu Item 

Let s begin at the highest level. When Lhe user selects the 
“Add Wiring To Button" menu item, QTFlash calls the 
QTFIash^AddWiredActionsToFlashMovie function, passing in 
the identifier for the movie in Lhe topmosL movie window. 
This function starts off by calling GetMovielndTrackType to get 
the first Flash track in the movie, and then it calls 
GetTrack Media to retrieve the media for that Lrack. Our 
current goal is to get the media data, which is the Flash data 
stream. We do this by calling GetMediaSample. Before we can 
call GetMediaSample, however, we need to find the media 
time ;u which the Flash track logins, like this: 

myTrackOffset = Gnt.Track.Offst>t (myTrack); 
myHediaTine ® TrackTimcToHcd TaTitnefinyTrackOffset „ 
myTrack): 


So we can get the Flash data stored in the Flash track like this: 

myErr = GetMediaSample(nryMedia* inySample. 0* NULL* 
myMedisTime , NULL. &mySampieDuration, 
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MULL, 


{SampleDescriptionHandle)myFlashDesc. NULL. 1, J 


&mySampleFlags) ; 


// initialfoe the end of frame flag 

isAtEnd = false; 


If we happen to know the character 1I> of the button that 
we warn to wire, we can then call the application function 
QTF lashSet W i red Act io n sTo B utton to attach an existing wired 
atom container (myActions) to that button: 


// loop through each lagged data block 
while UisAtEnd) f 

// gel tlie current tag and tag-end position 

myCode = GetTagO : 

myTagEnd = gFlashFstserUata ,iu_tagEnd ; 


myErr - QTFlash_SetWiredActionsToButtoTv{mySample, 
myButtonlD, myActions); 


QTFlash, however, assumes that we want to attach the wired 
actions to the first button in the Flash track, so well call the 
LocateFirstButton function to find the ID of that button, 
LocateFirstButton is defined in Listing 2, 


switch (myCode) E 
case atagEnd: 

// we reached Lhc end of die file 
isAtEnd = true; 
break; 

case stagDef 1 neButton?.: 

*theButtonID “ OJ32)GeLWord(); 

isAtEnd = true: 

break; 


Listing 2: Finding the first Flash button in a data 
stream 

Locate!'irsLtiuUon 

OSErr LocateFirstButton (Handle theStream, long 

•theButtonID) 

l 

if ((theStream = NULL) || (theButto.it ID = NULL)) 
return(paramEr r); 

* theButtortID = 0; 

InitFarserO ; 

gFlashParserData.m_theData = theStream; 

gFlashParserDaia.m_fileBuf “ (US *)*iheStream; 

SkipHeaderBlockO : 

gFlashParserData.m_fileStart s 
gFlashFarserData .m filePos: 

ParseTagstfalse, thefiuttonlD): 

return(noErr); 

1 


There s not! ling very intricate about LocateFirstButton; it 
simply sets initializes our Flash parser and then traverses the 
data stream looking for a tagged data block of type 
stagDefine Button 2. (Flash also supports buttons of type 
stagDefineButton, but they respond only to mouse clicks and 
cannot be configured to trigger actions on any of the other 
state transitions,) The main work here is accomplished by the 
ParseTags function, defined in Listing 3* 


Listing 3; Walking the data stream for a button 

Parselkgs 

void Parsel'aga (Boolean isSprite, long *theButtonID) 

I 

BOOL isAtEnd; 

U16 myCode; 

U32 myTagEnd; 

if (isSprlte) { 

U32 myTagld - (U32)CetWord(): 

U32 myFrameCount = (UJ2}GetWord(); 

] else f 

// set Ihe position to Lhe start position 

gFlashFarserData.m filePos = 

gFlashParserData,m fileSrart; 


case stagDefineSprite: 

ParseTags (true f theButtonID); 
break; 

defauli: 
break: 

1 

// increment paM the lag. 

gFlashParserData.m_filePos = myTagEnd: 
I 

1 


Onc e we 1 ve called GTFiash_SetWiredActionsToButton, 
we want to replace the original media sample in the Flash 
track with our updated media sample. This is code we've 
seen before, so we don’t need to investigate it in detail. 
Listing A shows our complete definition of 
QTFIash^AddWiredActionsToFlashMovie. 


Listing 4: Adding wired actions to a Flash track 

OTFkish _Ai kiWi red AetionsToFla sh Movie 

void QTFlaBh_AddWiredActionsToFlashMovie (Movie 
theMovie) 


Track 
Media 
TimeValue 
T i mnVal tin 
TimeValue 
TimeValut? 

TimeValue 


toy Track - NULL; 
myMedia = NULL: 
myTraekOffsor; 
myMediaTime; 
mySampleBuration; 
mySelect i onDuraiion : 
myMewMedieTime; 


FlashDescriptionHandlemyFlashDesc — NULL; 
Handle my Sample = NULL; 

short mySampleFlags; 

Fixed niyTrackEdltRate: 

QTAtomContaInfer my Actions *■ NULL 

long myButton10 = 0L; 

OSErr myErr = noErr; 


if (theMovie — NULL) 
return; 


//get The Iirsi (lash track from the movie 

myTrack - GetMovieTndTrackTypc(theMovtc. I. 
F1asbMedia Ty pc. 

mcvieTrackMediaType); 
if (myTrack = NULL) 
goto ball; 

// gel first media sample in the Flash track 

myMedia = GetTrnckModia (myTrack) ; 

If (myMedia — NULL) 
goto bail; 
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myTrackQffset - GetTrackQffset(myTrack); 
myMediaTime * TrackTimeToMediaTime(inyTi:ackOtfset P 
myTrack): 

// alloatie some storage to hold the sample description for the Flash track 

mylTashLesc = (FlashDe£ieriptionUandle)Ni?wliandle(4); 
if (myFlashDesc *= HULL) 
goto bail; 

mySamplo - NfivHandleCO); 

If (mySamplF — NOLL) 

goto bail; 

myErr “ GetHediaSample(myMedia* mySample, 0, NULL, 
rayHediaTimo. NULL. ^mySampleDuration, 
(SampieDescriptionHandleJnLyFlaehDesc. NULL* 1. NULL. 
&mySamplsFlags): 

If {jnyKrr !■ nnErr) 
goto bail; 

// add button actions; find the first button 
myErr - LocateFirstButton(raySample, ButtonID); 

if ((myErr I- noErr) || (rayButtonlD = 0)) 
goto bail; 

// create an act ion container for button actions 

myErr - QTFlash_Creaud3utianActionConta Inor[kmyActions); 
if (myErr != noErr) 
goto baii; 

// add button actions to sample 

myErr * QTFlanh SotWiredAetionsToButton(mySample , 
myButtonTD, myActions): 
if (myErr I st noErr) 
goto bail; 

// replace simple in media 

myTrackEditRate “ GetTrackEditRate(myTrack. 
myTrnckOffset); 

if (GotMovlesError() 1“ noErr) 
goto ball; 

GetTrackNextIntere 5 tingTime(myTrack. nextTisneMediaSsmple I 
nextTimeEdgeOK h myTrsckOffset, fixed 1* NULL. 
&raySelectionDuration); 
if (GetMoviesError() 1“ noErr) 
goto bail: 

myErr * DeleteTrackSegment(myTrack* myTrackOffset» 
mySelectionDuration}: 
if (myErr !“ noErr) 
goto bail; 

myErr = BeginMediaEdita(royMedia); 

If (myErr I- noErr) 
goto bail: 

myErr ” Ad dfied is Sample ( my Med la, 
mySample, 

0. 

GetFJandleSize(raySample). 
my Sam p1eDur& tion, 

(Sampl oDesc r iptionHand 1 e) myF 1 a shDesr., 

1 * 

mySample?lags t 
kmyNewMediaTime) : 
if (myErr noErr) 
goto bail; 

myErr “ EndHodiaEdltsEtnyMedia) ; 

3f (myErr I- noErr) 
goto bail; 

// add die media to the irack 

myErr “ InsertNediaIntolrack(myTrack, myTrackOfl'set. 

myNewHediaTime. mySolectionDuration. myTrackEditRate); 
if (myErr 1** noErr) 
goto baU; 

ball: 


if (nryActions != NULL) 

(void) QTDisposeAtomContainet (myAclions); 

if fmySample f- NULL) 

DisponeHartdle(mySample); 

if (myFlashDesc I- NULL) 

DlsposeHandle((Handlo)myFlashDosc); 

I 


So our work will l>e finished once we've defined the 
fuaction QTFIash .SetWiredActionsToButton. 


Finding Actions for Button Stale Transitions 

As well see in greater detail later, the button actions 
contained in a data block of type stagDefineButton2 are 
grouped into lists according to the button state transitions 
that trigger them. However, a wired atom container (such 
as the one created in QTFla sh by a call to 
QTFfash_CreateButtonActionContainer) might contain 
several event atoms. The event IDs of these atoms can be 
any of the nine button state transition constants we 
encountered in the previous article: 


//define kTdleToOverUp 
//define kOverUpToIdle 
//define kOverUpToQverDown 
Jdeftne kOvcrDownToOverlJp 

$de fine kOve rDownToOuL Do wn 

( define kOu t DownToOve rDown 
define kOutDownToIdie 

llfdefine kTdleToOverDown 
^define kOverDo^nTnldle 


(1L « bsldleToOverUp) 

(1L <( bsOverUpToTdle) 

(1L « bsOverUpToOverDown) 
(1L < < bs 0ve rDownToOve rtl p) 

(1L it bsOverDownToGutPown) 
(1L ii bsOutDownToOverDown) 
(1L « bsOutDownToIdle) 

(1L << bsId1eToOverDown) 
(IT, << haOvnrDownToTdle} 


For each of these nine button state transitions, we need to 
extract from the wired atom container the event atoms of tliaL 
type and then add ihc extracted atoms into the action list for 
the specified button. This is precisely what 
QTFIash_SelWiredActionsToButton accomplishes, as you can 
see in Listing T 


Listing 5: Finding actions by event type 

Q ll lii sh Jk-I WjRtlAt tioasToBt it ton 

static QSErr QTFlash_SatWiredActionsToRutton 
(Handle theSample, long theButtonlD, 

QTAtomContainer theActions) 

I 

short myIndex; 

EjTAiomCuntainer my Act lonConta I nor; 

QTAtom my Event Atom =* 0; 

QTAtomlD myEventID: 

OSErr myErr; 

myErr = QTNewAtQmContainer(^myActionContainer); 

If (myErr != noErr) 
goto bail; 

for (mylndex - 0; myindex < (sizeof(gFlashCondiLions) / 
sizeof(long)); myindex’H-) I 
rayEventID * gFlashConditions [mylndexj : 

myEvfintAtom = QTFlndChildBylD[theActions. 

kParentATomTsCroitainor, kQTEventType, myEventlD, 
NULL); 

if (myEventAtom f 3 * 0) I 

myErr = dTFlash_CopyChildren(theActions, royEveTitAiom, 
myActionCtmtainer, kParentAtomlsContainer); 
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rayEventAtotu = QTFindChildByID(theActions, 

kFarentAtoinlsContaifi&r, kUTEventType, ray Event ID, 
HULL): 

if (ray Event: A tom !“ 0) l 

ray Err ’ QTFla6h_CQpyChiIdren(thfcActiemE r myEvent Atom, 
laiyActlonCoiUe lner, kParentAtomlsContainer) ; 

if (rayEtr !** noErr) 
goto hail; 

QTFlash SetWlredActionToBirttofl (theSample. 
thoBnttorxTD, 

myEvenrID, inyActicmContainer) ; 

mySrr ® QTReraoveChi1drontrayActionContainer* 
kParentAtoinlsConLa i nor) ; 

if (myErr != noErt) 
goto bail; 

I else I 

QTF1aeh_SetWiredAttionToButton(theSample, 
the? But tonTD* 

myEventTD, NULL); 

I 

I 

myErr * QTDisposeAtoiiContainer(myActionContainer); 

bait; 

return(myErr); 

1 
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Figure 5. Data for a block of type slagDefmeButton2 


We won t dissect this function in detail. Essentially, it 
looks into i he atom container theActions for actions to be 
triggered by the nine distinct button state transitions. For any 
button state transitions that have actions, it extracts the 
appropriate event and action atoms into a new atom 
container and calls QTFI as h_Set Wired Act ionTo Button, Note 
that, if theActions does not contain an action for a specific 
button transition state, then QTFIash_SetWiredActtonsToButton 
calls QTFIash_SetWiredActionToButton with the last parameter 
set to NULL; this is a signal to QTFIash^SetWiredActionToButton 
to remove any wired actions of that kind from the target Flash 
data stream, 

Reading the Button Data 

QTFIash^SetWiredActionToButton is the real workhorse 
here. Its job is to parse the data associated with a specific 
button and to add an action of type saction Wired Actions 
that is to be triggered by a specific button state transition. 
So, to understand QTFfash.SetWiredActionToButton, we 
need to understand the format of the data in a tagged data 
block of type stagDefineButton2. Figure 5 gives a picture 
of how the data in that block is arranged. 


The tagged data block begins with a tag header, of course, 
whose tag ID is stagDefineButton2, Immediately following die 
tag header we find a 16 bit character ll> and an 8-hit menu 
Hag (which determines whether the button operates as a 
push button or a menu button). Then we encounter a 16-bit 
integer that is the offset from the current location in the data 
stream to the first button action condition* Each button 
action condition specifies one or more actions that are to be 
executed on a specific button state transition. Between the 
offset word and the but ion action conditions are one or more 
button records, which specify the images to lx* used for each 
of the three button states. For present purposes, we don't 
need to knmv the structure of these button records, since 
well jusL lx skipping over them (using the offset word) 
when we process the tagged data block. 

So let’s get started. QTFIash_SetWiredActionToButton is 
passed four pieces of information, which are the Flash track 
media sample (that is, the Flash data stream), the character 
ID of a button, an event ID (that is, a button slate transition 
constant), and an atom container of wired actions for that 
button and button state transition. First we want to tell our 
parser what data to use; 

gFlashParserData .m_thel>ata = the£ample : 

Then we want to find the byte offset in that data stream 
of the beginning of the tagged data block that holds the 
information alxnu the sjxxifSed button. We'll call another 
QTFlash function to get that offset; 

myGffset = GetOff setForButton (theButtonID); 

GetOffsetForButton is easy enough to write; once again, it 
uses the parsing code we developed in the previous article 
(listing 6). 
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Listing 6: Finding a button in a Flash data stream 

GetOfFsetForikitton 

tf32 GetOffsetForButton (long theButtonlD) 

I 

BOOL IsAtKnd = false; 

U 16 rnyCode: 

U32 TnyTagRnd: 

U32 rayTagIB; 

gFlasbParserData.m_fiieBuf = 

(D8 “) ‘ gFlashParserData ,m_thel)ata; 

// sci the position to the start position 

SkipIlcadcrRlockO ; 

// loop through cadi lugged data hk>ck 
while UisAtEn&j I 

// gel the current Ug and tag-cml position 
my Code - GetTagl): 

myTagEnd = gFlashPar serData . m_tagErid; 

switch (myCode) { 
case stagF.nd: 

// wr reached the end of the file 

isAtEnd - true; 
break; 

case stagDetine0Utton2: 
myTaglD - (U32)GetWordU: 
if (myTaglD = theButtonlD) 

returnTgFlashParserData-nv. tagStart); 
break; 

default: 
break: 

I 

// increment past the lag 

gFlashParserData.ra filePoa = myTagEnd: 

) 

return(0); 

I 

Once we’ve determined the starting position of die 
button data block, we need to pass that information to our 
parser and then read past tlie tag header: 

gFl a t?h Parser Data .m fileBuf = (US *) * theSampl & i 
gFlushParserData . m_f i 1 ePos = myOffset; 

(void)GetTagf); 


At this point, g Flash Pa rserData.rnJilePos points to the 
first byte in die button data. Let's skip over the character ID 
and the menu flag, to position our data pointer at the offset 
Held, Well need to remember the location of this field for 
later, so well store it in the variable myOffsetLocation. 

g B J s a h F a t s erData, k_ f i It Ft & += & \ ttn f 11| lfi): // step over 
character ID 

gFiashParserData,ra_filePos +~ Bizcof (LIB); // Step over 

menu flag 

myOffset Location * gFlashFarserData.nj_f itePos; 
BiyButtonRecordLength ** 0; 
myAetiunCoum = 0; 

We also want to retrieve the value in the offset field, so we 
know how far ahead in the darn stream to jump to read) the 
first button action condition: 

myOffset - (U32)GytWord0; 

Now let's reposition the data pointer to point to the first 
but i on action condition: 


gFlashParserData,m_fiIeFos + - myOFTsct - sizeof(U16): 

Notice that we jump ahead by myOffset hut then back up 16 hits; 
this is because the call to GetWord advances the pointer 16 bits, 
but myOffset is the offset from the beginning of the offset field. 

For simplicity, let's assume that the existing burton data does 
not contain a button action condition for the specified state 
transition that already contains a wired action. This means that 
we can just insert a new button action condition at the head of 
the existing list of button action conditions. (Tlie code to handle 
the general case is fairly complicated but not terribly 
enlightening; but don't fret: the source code for QT Flash contains 
the full definition of GTFIash SetWiredActionToButton. ) So were 
going to move the existing list of button action conditions down 
in the data stream to make rtx>m for our new condition, let’s get 
a few sizes: 

myAetianHandleSize - GetHaridleSiZel {Handle) th<?Actton) : 
OiyMaveAriount = myDataHandleSize - tnyStartAc tioiiOf fseL: 
myI n tteaseAmount = nizeof(UI&) + sizeof(U16) + 
sizeof(UB) + 

sizeof (Uib) + myArtionHandleSize + sizeof(U&): 

ByDataHandleSize +■= myTncreaseAmaunt: 

Now we need to resize the handle that holds the Flash 
data stream and move all the existing button action 
conditions down: 

Setifimdli&Si-zeftbeSawpIe, myDstaHand LeS.ize) ; 
myErr = KemError(): 
if (myErr 1= troErr) 
ftoto bail; 

B1 nckMove{'theSample + myStartActionOffeet. ‘theSample 
+ 

myStarrActicmOffset * mylncrcaseAroount, 
rnyMoveAmount}; 

At this point, we want to const met a new button action 
condition. Lei’s set myPtr to the first byte of the new but ion 
action condition: 

myPtr — *the5ample + myStartActionOffeet: 

A button action condition begins with a 16-bit offset to the 
next action condition. If, on entry to 
QTFIash_SetWiredActionToButton, we determined that there 
were no actions in the button data (which is possible but not 
very useful), then well set ihal offset u> 0; otherwise, well 
set that offset to the length of the new button action 
condition: 

if (myActfonCount >0} I 

INSERTEDl6_AT_L0C(mylncreaneAmount:, myPtr); 

1 else ( 

*(UI& *)myPtr =0; 
myPtr +“ sizeof(Ut&); 

I 

The mac ro INSERT U16 AT LOG inserts the specified 16-bit value 
at the specified location, making sure that that value is written in 
little-endian form; INSEFfT_U16_AT_LOC is defined like tliis. 

//define IHSERT_U 16_ATJL0C tval, loc) 
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*{U8 *)loc++ - (val & Oxff); 

*(UB *)loc++ - ((val >> 8) 6 Gxff) 


We continue writing data into our new button action 
condition. Next we patch in the condition: 

INSERT_UI6_AT^L0C( Lite Condi t toil, myPlr) ; 

And then we patch in the action type (namely 
sactionWiredActions) and the length of the action data (which is 
of course the length of the atom container): 

*fU8 *)myptr - sactionWiredActions; 
my Pl:r += i zsof ((J8) ; 

T NS ERTJJ 16_AT J,OC(my Act inn Handles 1ss«. myPfr) ; 

We 1 re finally ready to insert the atom container that holds 
Lhe w ired actions. Each button action condition must end with 
an K-bit field whose value is 0 f so well write that too. 

BlockHove(’theAction. rayPtr, myActionHsndleSize); 

* (royPtr * myActiotiHandleSize) - 0 : 



To finish this off, we need to patch in the original offset 
to the button action conditions, if that offset was originally 0 
(that is, if originally there were no actions in the button data), 

if (myActionCount — 0) i 

myPtr = *thp.SampJ e t myOf f setLocation: 

TN5ERT_U 16_AT_riOC (myRu r r onRer.nrdL^ngr.h , myPtr) ; 








Adjusting Length Tags 

We are almost finished attaching a QuickTime wired 
action to a Flash button. We've spliced a new button action 
condition into the button’s data block and we’ve updated (if 
necessary) the offset to die list of button action conditions. 
So the actual data in the button's tagged data block is now 
complete and correct, There remain, however, two length 
fields that we need to reset: (1) the data length field in the 
tag header, and (2) the file length field in the file header. We 
need to add my In crease Amount (the length of the new button 
action condition that we added) to each of the values 
currently in those fields. We do that by calling the application 
function SetNewHeaderAndTagLength, like so: 

SetNewHeaderAndTagLengthtrayincreaHeAmount. 
mylncreaseAmount) ; 

Listing 7 shows our definition of 
SetNewHeaderAndTagLength, On the whole this function is 
straightforward; the only real complication arises from the 
fact that a tagged data block header can occupy 2 or 6 bytes, 
depending on the size of the data in the block. 
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if ( "you_need_training" ) { 

if ( "you_need_resources" ) { 
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if ( “you_need_it now" ) { 
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Listing 7: Adjusting the file and tag lengths 

Sel N cw He adt-rAndTag I .trngr h 

void SetNewlieaderAridTagLanglh (U32 theFileftifferenea, 
U32 theTagUifferenee) 

I 

US ‘s; 

U16 myCode, myNewCode: 
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U32 myLength * myF1leLength; 

tong myftandleSizo: 

Boolean tny IsLtm&Tag = false: 

QSErr myErr = tioErr; 

// point al the first byte of the 4-byte iile-Icngth field in the header block; 

// It'S at offset 4 Id the header block 

s - {08 *>*gFlashParscrDara.m_theData + 4; 

// read the current file length 

myFlleLengUi - (U32)sl0l I (<U32)s[lj « «) | 

({U32)sUJ « 16) | ((U32)s131 « 24): 

// jnereniem the file length 

myFileLength theFilaDiffnronent 
^I□] “ (royFilsLength k OxFF): 
fl[l] - ((rnyFllebength >> 8) & Oxff): 
at 2] " ((otyFileLangth >> 16) 8 Oxff); 
a[3l - ((nty Fil e Length » 24) k Oxff); 

// point at liKf first byte of die current tag 
b * (US 4 )^FlashParaarData,m_thaData + 
gFlaahParserData . m._tagStai t: 

// get the com hint'd code and length of t he tag 

myCode - (U16)s[0] | [(Ulft)sll| « 8); 

// the length is encoded Lit the lag 

myLength * myCode & 0x3f: 

// remove the length from the code 

rayCodr * myCodo » 6; 

// determine whether another long word must he R-ad to gel the length 

if (myUngth “ 0x3f) I 
& •+- eizeof(U16); 

myLength = £U32]sfOl | UUTZMH « fi) | ([032M2I « 
I ft) 

| UU32)s [3] << 24) : 
tnylsLongTag “ true: 

I 


myLength += theTagDiiference; 

if (myLength >— 0x3f) I 

nyNevCode - (myCode << 6) | Oxif; 

if (imytni-ongTag) I // need more space 

myHandlcSize = 

GetUaridleSize (gFiashPa rserData . na_theOata?: 

myHandleSize + Jtl sizeofdong) ; 

SetHandieSize (gFlashParserData, ai_t hcOata, 
myHand1eSIze); 

FnyErr = MemEr rorO ; 

If (myErr != tioErr) 
goto bail; 

// now shift die data up 

BlockHovn£ 

*gFlashParset Data.m_thoUatfl + 
gFlashPa rserfiata.ra_tagStarL f 

•gFlashFat secDatu,m^ihcData + gFIashParserData ,tn_tag£tart 

+ 

sizeof(long), 

(myiiandleSize sizeof (long)) - 

gFiashParserData.m tagStart); 

myFileLongth sisteoftlong); 

i 

is - (U8 *)*gFiashParserbata.m_theData + 4; 
js|0j = (myFiieLength 6 Oxff) : 
all] * (ImyFileLengtii >> 8) k Oxff); 
s|2] = ((royFileLength » 16) k Oxff); 
af3) * ((inyFtlehengrh » 24) k Oxff): 

a s (08 4 ) 4 gFlashParBorData.m_theData + 
gFla»h?Brserl1ata,T!i_tag8tart: 

s|0j * (tnyUeuCode k Oxff); 

sfl) - [ (myNewCode >> 8) k Oxff); 

n +“ aixoof (III 6); 
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s[0] = (myLength b Oxff); 
s[lj - UmyLength >> 8) f» OxfE): 
s[21 - ( (ay Length » 16) & Oxff); 
s[3l = ((myLength » 24) 6 Oxff): 

I else I 

niyNewCutk’ • (If 16) (myCode << 6) | (If 16} (ityLength A 
Ox3f): 

if (myisLongTag) t 
myHandleSize - 

GotHandleSlze(gFlfli3hParserData,iB theData): 
myHandlcHtxc = nizonf(long): 

if shift the data Unwn 

MockMoye ( 

•gFXashParsecData.ni.theData + gFlashfarserData .m_LagSt in l 

+ 

nixecrf(long). 

"gPlo^hPerficrOatfl .m_theDar.ii + 

gi’lashParseillaLu.fli_lagStdr l , 

(myHatidieSize sizeof (lung)) 

gFlashParserLiaui .m_tagStan): 

SetHandleS1 2 e(gFla shPa r serUa t a.m_t heDa t a * 
myHandleSixe): 
myKr r 3 M^mF.rror (); 

If (myErr !” nuKrr) 
goto hail; 

myFiieLength = sizeof(long); 

J 

s - (US *)'gFIashParseiData.m the Data + 4; 
fr[0] * (myFS loLongth A Oxff); 
all] = ((myFiloLongtb >> 8) b Oxff); 
ii[2] ~~ ((royFIleLength >> 16) & Oxff): 

«[3] ^ ((ntyFileLtmglh >> 24) b OxII) : 

s - (US ■) VgFiashParserData .nutheData + 

gFlashPa r serData*nutagS tart: 

n[0] - (myNewCod^ h Oxff); 

s(l] = ((myNcwCode >> B) b Oxff): 


bail: 

return: 

1 


Conclusion 

hi this article, we've investigated some ways to use 
QuickTime's wired actions in conjunction wiih Flash tracks. 
We've seen that QuickTime provides a handful of actions 
that we can send to Flash tracks, along with a single 
operand that we can use to gel information from a Flash 
Lrack. Perhaps the most useful wired action that can be 
targeted at a Flash track is kActionFlashTrackSetFlashVanable, 
which allows us to interact with AetionScripts attached Lo 
Flash elements. We can also use this wired action to 
dynamically set the text of a text item in a Flash track, 
without any assistance from Flash AetionScripts. 

We've also seen how U> einlxrd wired actions in Flash 
files. We've walked through the steps involved in adding 
wired actions to a button, and similar code can he used to 
add wired actions to a frame in a Flash animation. 


Credits 

The code for adding wired actions to Flash movies is 
based heavily on some code written by Bill Wright. 
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PROGRAMMER'S 

CHALLENGE 


by Boh Boonstra , Westford MA 


S*x£hart 

i don’t know which is more puzzling, the tact that people 
write these things, or the fact that I read them. Or perhaps it was 
just a slow news week, even for Wired, But when your daily 
headline email is headlined "SexcharT, you've just got to follow 
the link to see what’s on the other side. And I'm always on the 
lookout for a novel Challenge idea - you never know where 
ihey might appear. 

You can cheek out the link 

(http://www.wired.eom/news/culture/0,12 84 r 4899 7,00. htm I > 
yourself, but the gist of it is this. Someone got the idea of 
showing just how, well, “connected" one of the more 
promiscuous members of the internet world was by representing 
individuals as dots on a two-dimensional graph, and connecting 
them wilh a line whenever they had, or, "hooked up'\ Over time, 
the graph grew to more than 1400 individuals and their 
assignations. The definition of what is required to connect two 
people with a line is provided in the referenced article, 
something about what sons of disease can lx* spread by the 
contact, but that's not relevant for our purpose. 

So what does this have to do with the Challenge? if you 
look at the Sc xC hart 

(htLp://www.attritton.org/hosted/sexchart/sexchart:9.25), you 
can see that it has some deficiencies. First, ids done in ASCII, 
which limits the connecting line segments to a few 
orientations provided by a small number of characters. 
Second, the graph has grown up over time and, frankly, it 
has gotten a little messy. Certainly we can help. Your 
Challenge Lhis month is to produce a better SexChart. 

Entries this month will be complete applications, so there is 
no prototype for the code you should w rite. Your program must 
process a sequence of test cases, the number of which is 
provided in the file SexChart,in. The input lor lesi case NN 
begins with a file (namesNN,in) containing the names of 
everyone in the graph. The first line In the file is the numlier of 
names it contains, followed by one name per line. 

53 

crank 

Kissin Tell 
Metalchic 
Alan Mndu&a 

piglet 

Wicked Fixie 

The rest of the test case input is a file (hookupsNM * in) 
indicating who is connected with whom. Again, the first line in 


the file is the number of relationships that follow. The file might 
look something like this: 

40 

crank,Alan Medusa 

crank,piglet 
crank,Handsomn Harry 
Metalchic,Kissin Tell 
Metalchic.Handsome Harry 

Handsome Harry,Wicked Pixie 

Your objective in this Challenge is to place all of the names 
on a graph and connect them using a mulLi-segmenl in a way that 
minimizes the number of intersections among the connecting 
lines. If ihe line connecting names A and B intersects the line 
connecting C and I), you earn one penally point for each place 
that they intersect, Cotlinear segments (not desirable) earn one 
point for every unit of overlap length, Your code should produce 
three output files. The first one (locationsMN. out) contains 
one line for each name on the graph, with the integer horizontal 
and vertical coordinates at which the name is placed: 

50,1GO,crank 

100.150,Handsome Harry 

?.5, i50.Wicked Pixie 

The second output file (segmentsNFLout) contains a 
sequence of points connecting each pair of names in 
hookupsNN.txL The first and last point in each sequence 
correspond lo the locations of the names being connected. So, 
1 1 .ir tl le I i ne u jn n eel i ng era n k will i 11 a n dsc )n ic f I aery, the segm e nl 
file might contain this ... 

3 

5QJOO 
7 5 r 125 

1 00 J 50 

followed by this for the connection between Handsome 
Hairy and Wicked Pixie: 

2 

100.150 

25.150 

'the final output file Clogfile*txt) should contain one 
line for each lest case, containing the amount of execution time 
in milliseconds required to process each test case, measured 
from before the input is read through the time the output files 
are generated. 

Your solution should display she graph generated for 
each rest case, showing the location where each name has 
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been placed, and the line segments connecting each 
specified pair of names. You should provide the ability to 
resize the window in which the graph is drawn, and vertical 
and horizontal scrolling capability if needed to see the entire 
graph. You should provide menu control allowing the user to 
advance to the next test case. You can provide other 
capabilities as desired to improve the discretionary pan of 
your score (see below). 

Scoring will be based on minimizing the number of 
points your solution incurs. You earn one point for each 
nontrivial intersection of line segments in each graph that 
you generate* You incur an additional point for each 100 
milliseconds of execution time your solution requires to 
generate the graph. The time required to display your graph 
after ii lias been generated does NOT count and does not 
incut points* However the quality of your display along with 
any additional features provided in your program may earn 
you a bonus reduction of up to 25% of your points. The 
bonus will be awarded based on a subjective evaluation of 
the quality and attractiveness of your application. 

Tins will he a native PowerPC Challenge, using any of 
the following environments: CodeWarrior, REAlbasic 
(version 3,2,1 or earlier), MetaCard (version 2.3.2 or earlier), 
Revolution (version 1.1), or Project Builder. You may use 
another development environment if 1 can arrange to obtain 
a copy - email progchallenge@mactech.com to check before 
you use something else. You can develop for Mac OS 9 or 
Mac OS X. Your solution should be a complete Macintosh 
application, and your submission should provide everything 
needed to build your application, as well as documentation 
of the features you have implemented, Lo ensure that 1 don't 
overlook anything. 


Winner of the November, 2001 Challenge 

The November Challenge required contestants to write a 
player for the ancient game Seega. Seega is played on a 5x5 
board (generalized to larger boards for the Challenge), where 
players capture pieces by moving to positions where an 
opponent's piece is bracketed by the piece just moved and 
another of your pieces. Two players entered the November 
Seega contest. Congratulations to Ernst M tin ter (Kanaia, 
Ontario) for defeating returning contestant Alan Sienger, 

As it turns out, both players played the game very 
conservatively, and every contest resulted in a stalemate. 
Both Ernst and Alan observed dial stalemates occurred 
frequently during their testing, and might be an appropriate 
winning strategy, although neither of them adopted an 
explicit stalemate strategy in their code, in each of my test 
cases, the first player to move (the second player to place 
pieces on the board) was the one who had the most pieces 
on the board when a stalemate was declared, and therefore 
was declared the winner of the game. Alan actually won 
games by a larger cumulative margin, as much as 6 pieces in 
a 7x7 game, but his code took much longer to execute than 
Ernst's. But scoring was based on the number of victories, 
minus one win for each second of cumulative execution 
time, so Ernst’s entry was the winner. Since our second-place 
finisher has not won a Challenge in ihe past 24 months, this 
month’s prize will be split evenly between Ernst and Alan. 

The table below lists, for each of the solutions 
submitted, the number of games won, the number of pieces 
remaining in all games, the toLal execution time in 
milliseconds, and the cumulative score. It also lists the code 
size, data size, and programming language of each entry. As 
usual, the number in parentheses after the entrant s name is 


RKALhasic 
AppleScript 
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Java 


SQL 
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XCMD 
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live tout! number of Challenge points earned in all Challenges 
prior to this one. 


Name 

Wires 

Pieces Time 

Score 

Code 

Data 

tang 



(msec) 


Size 

Size 


Ernst Mumer (7801 

6 

1% 1)1.62 

5.4684 

8218 

1847 

C++ 

Alan Slender (65) 

6 

I65I97H07.9 

8 

-191 «0H 

4684 

878 

C++ 


Top Contestants 

Listed here are the Top Contestants for the Programmer's 
Challenge, including everyone who has accumulated 20 or 
more points during the past two years. The numbers below 
include points awarded over the 24 most recent contests, 
including points earned by this month’s entrants. 


Rank 

Name 

Points 

Wires 

Total 



(24 mo) 

124 mo) 

Points 

1. 

Muntc-i. Fmsi 

253 

9 

800 

1 

Kickcn, Willdie 

73 

3 

134 

3- 

Taylor, JonalJan 

59 

2 

63 

4. 

Claes 

19 

2 

49 

5. 

Saxton, Tom 

35 

1 

m 

t7 

Maurer* Sdustran 

51 


m 

10. 

Mailed. Jeff 

20 

1 

114 

11. 

Tm.sk ier, Peter 

If) 

1 

m 

12. 

Cooper, Tony 

20 

I 

m 


... and hie Top Conitsiants Looking ior a Recent Win 

In order to give some recognition to other participants in 
the Challenge, we also list the high scores for contestants 
who have accumulated points without taking first place in a 
Challenge during the past two years. Listed here are all of 
those contestants who have accumulated 6 or more points 
during the past two years. 


Rank 

Name 

Points 
(24 mo) 

Total 

Points 


6. 

Boring, Handy 

32 

144 


8. 

Saddsky, Gregory 

22 

24 


9. 

Shearer, Rob 

21 

62 


13. 

Schotsman, Jan 

14 

14 


14. 

Stenger, Allen 

10 

75 


13. 

Nepsund, Ronald 

10 

57 


16. 

Hart, Aian 

10 

35 


17. 

Day, Mark 

10 

30 


18. 

Downs* Andrew 

10 

12 


19. 

flowers, Sue 

10 

10 


20. 

Fazekas, Miklcxs 

10 

io 


21. 

Dcsch, Noah 

10 

10 


22. 

Nicolle, Ludovk 

7 

55 


23. 

Miller, Mike 

7 

7 


24. 

Leshner, Will 

7 

7 




RACKMOUNT 

YOUR 

MACINTOSH 


Power Rack — rackmount chassis for PowerMac G3 and G4 


G*Rock — rackmount for PowerMac G3 and G4 tower coses 


IRack — 1 RU rackmount chassis for iMac 


Rackmount solutions and 
accessories designed 
for the Macintosh 

800 - 832-6326 

www.marathoncomputer.com 
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MARATHON 


February 2002 * MacTech 


COMPUTER 





































































There are three ways to earn points: (I) scoring in the top 
5 of any Challenge, (2) being ihe first person ro find a bug in a 
published winning solution or, (3) l icing the first person to 
suggest a Challenge that I use. The points you can win are: 


t.sl place 

20 points 

2nd place 

10 points 

3rd place 

7 points 

4th place 

4 points 

bill place 

2 points 

finding bug 

2 points 

suggest ing Challenge 

2 poinls 


Position 'moveFrom* 

f* location you arc moving from.(4, 1) if you cannot move V 
Position 'moveTo, 

r location you arc moving to, if you cannot move 7 

Boolean •bloekod 
/* fr turn TRITF if you can not move */ 

> 

I 

assert(P); 

'blocked = 

!F- 

>MovePiace (board, followUpMove.moveFrom*rnoveTo); 


void TertnGanie (void) 
i 

delete P; 

1 


Here is Ernst's winning Seega solution: 


Computer Player.h 


SEEGA.CPP 

Copyright © 2001 
Ernst Munter, 

Kanata, ON, 

Canada 

r 

Submission to MacTcch Programmer's Challenge for November 200 J, 
“Scega* 


r 

Header file for die SEKtiA game. 

Copyright O 2001 + Ernst Munter, Kanata^ ON, Canada. 

Hi is header file supports "sccga.cpp'’ which contains the external 
inter luce. 

version 0 


This is work in progress, and is not likely to get finished by tile deadline. 


Hi is file contains die external interface, 

XompuicrPlaycr.IT’ provides the implementation of logic. 

7 

#include “Setjgn.h” 

//1 nc 1 udo ’*ComputorPlaycr.b” 


Assumptions 


Jlic size of the hoard is less than about 100 x 100 to allow some 
variables 

to he stored in diars, 

V 


static ComputerPlayer * P; 


void InitGame( 

int boardSize, 

r number of rows and columns, odd integer >= S 7 

char pleceValuOt 

r value assigned to your pieces, l^numbefOlPlaycrs 7 

Boolean playFirst. 

1* TRUE if you place pieces first (and move second) 7 

int stalemateThreahold 

P stalemate will lx 1 declared after this number of moves without a 
capture 7 
) 

( 


If (P) delete P; 

P — new ComputerPlayer{ boardSlze, 
playFirst» 

stalemateThreshold); 


} 


pieceValue, 


void PIaeePleees{ 
const Board board ( 
t hoard slate before you place pieces 7 
Position 'placePiecel , 

/* place a piece at 'placePiece) 7 
Position *placePieee2 
t place a piece at 'placePiece2 7 

l 

assert (?): 

P >P!acePieces(board.plaeePiecel.placePieee2): 


void MovePiece( 

const Board board* 

r board state before you move a piece* updated by test code 7 

Boolean fol1owUpMovc, 

/* Titl JR if you must make anot her capture with the last piece moved 

7 


tfifndef COMPUTER_PLAYER_H 
^define COMPUTER PLAYER H 

ifdf'f i nc xNDEfiUG 
//include {assert*h> 

//include <stdlib*h> 

^include {string.h> 

//include "seega. h** 

//define DBG 0 
ih f DBG 

//include ** seega W1 nd ow. b " // provides a fawd disp I ay for 
debugging 

extern SeegaBoard' gDispIay; 

//end! f 


typedef unsigned char uchar: 
typedef unsigned long ulong: 
typedcf unsigned ehort ueh n rt; 

on urn 1kE=0.kS=1,kW=2.kN ^i. 
kEmpty=0 t 
k0utside=3, 

kCa p tur e F a ct o r = 1 
I ; 


inline long Opposite(long dir)I return dir A 2;I 

// Standard CRC based lush method, 
static struct CRC I 

enme \ POLYN0MIAL“Ox04c11db 7Li; 
ulong table[256]: 
ulong accum: 

CRC() 

( 
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A New System Has Arrived 



No Mac is complete without Timbuktu Pro, 
the premier remote control and file transfer 
software for Mac OS for over ten years. 

No network is complete without the smart 
systems management of netOctopus. 


Both tools are newly rewritten for OS X, 
bringing the power and simplicity of Netopia 
software to the world’s most advanced 
operating system. For deployment, training 
and support of all your Macs (and PC’s!) 
Timbuktu and netOctopus are indispensable. 


Are you ready to migrate? We’re ready to take you there. 


Timbuktu Pro 


macosxready.com 

netopia. 







long 1 « j * x; 

Tor (1=0: t <256 : 1 ++) I 
x=l«24; 

for tj=0;j<£;j++) 1 

it (x<0) x={x«I) A POLYNOMIAL i 

else x^(x<<1): 

} 

table fll=x; 

I 

accum=0; 

1 

void Clear()(aceum-O:1 
void HashPosition(Position p) 
f 

ulon^ acc r -accuin; 

acc=(acc<<8) A table[OxFF & {{acc>>24) A 
p.row)| ; 

aeeuiif“Caec«8) A table[OxFF & ((acc>>24) 
p. col)]; 

) 

ulong HashResult() const [return accum;) 

I crc; 


class My Cell 

class MyCell 

I 

uchar row: 
uchar col: 
uchar pValue; 

uchar state: // MSB indicates center cell 
enum EkCenter^GxRO); 

My Cell 1 one [41 ; // one move away, east to north 
MyCe N ■ run \k | : // two moves away. cast to north 
MyCi 1 1 1 * rit'xi ; // linked l\s\ of mine or opponent's cells 
public: 

void Lnit tint r.int c*int size,MyCell* outside) 

I 

oneLkEj=(c<size-1) ?(this+l) :(outside): 
one [kS] “(iKsize-1) ?(this+size) :[outside): 

one fktt] = (c>0) ?(this-i) : (outside) ; 
one[kN]=(r>0) 7 (this size) :(outside); 

two [kK]-(c<»i ko- 2) ?(Uit::+2) : (outside); 

two[k$]“(r<size 2) ?(this+2* size) :(outside); 

two [kWJ=(c>l) ?(this-2) :(outside): 

two [kN]“(r>1) ?(this - 2 'size) :(outside): 

cow=r: 
col ; 

pVslue=kKrJipl y: 

If ((r=c) && (r=size/2)) 
srtateHs Center ■ 
else state=D; 

3 

void SetOutsideO 

[ 

memset{ r h i s , 0 . s tzoof(*this)); 
pVa)uo=kDurs3 do; 

I 

bool isCenter() const I return (state & kCenter) :I 
bool fsLmptyO const l return pValue—0;} 
long PValueO const \ return pValua; 1 
MyCell* Next() const [return next;] 

Position Post) const [ 

Position pos; 
pos, rethrow; 
pas * col~col; 
return pos: 

MyCel 1 4 One(int dir) const (return orre[dlr);l 
MyCell* Two(int dir) const (return twn[dir]:l 
bool HssNeighbor(long x) const 

I 

if (one[0] >pVaiue =z= x) return true; 
if (one [ 1J ->pVaiue=x) return true; 
if (one [2 ] - >pValue^x) return true; 
if (one [3]->pValtie=x) return true; 
return false; 

I 

long Tli real () consi l return state;} 


void Sot Pya.l tie (1 ong x) (pValuc^x;} 
void Link(MyCell* b C) lnext=C; C=this:) 

bool Captures(MyCell* target.long pid.int dir) 
const 

// returns true if'this* cell (moved onto hy pid) captures the target. 

[ 

if ((twofdir] >pValue != pid) | 

(target >pValue+p1d t" 3} || 

largeL >IsCenter() 

return false: 
return true; 
l 

long Distance(MyCell* C) const 

( 

long dRow^(row>C >row)?row G >row;C >row row; 
long dCul - (eol>C >col)Vcol C->col:C >col col: 
return dRow+dCol; 

1 

void SetThreat(long caps)!state^caps:! 


struct EaveCell 

( 

MyCell* C: 
long v; 

void Init(MyCell* CC.long vv)[C^CC:v^vv:I 


class MyBoanJ 

clans My Roar rl 

( 

protected: 
long size; 

long length: //-si /e* s i m 
MyCeli* cells; 

MyCell* sentinel; 

MyCell* cell List [3] ;// [of pVktue = 0, L 2| 
long nuniPi ecos; 
ulong opponentllash; 
ulong opponentHasMoved; 
public: 

MyBoard(long boardSize): 
size(boardSize)* 

Iengtb{boardsize*boardsize) , 

cel 1 s (nr<w My Cel 1 [ 1 ength+ I j ) .//l extra for outside sentinel 
nunil’ieces ( 0) , 
opponentHash (0). 
opponentHasMoved(0) 

I 

MyCell* C-cells: 

sent ine 1—&cel 1 s [boa rdSi zi* * boards ize] ; 
for tint row=0;row<E1zn;rnwtO 

l 

for (lm col =0;co 1<s i xo:cu1++) 

f 

C->Init(row,col*size,sentinel); 

C++; 

J 

I 

nonr i no 1 >Set Outs i d o. f) ; 

I 

-MyHoard() 

l 

delete [J cells; 

MyCell* CenlerCellf) const [return cells+length/2;] 
ulong C(j»pute0pponontHasb(long pid) 
f 

crc,Clear(); 

MyCell* C=cellList U-pidJ ■ 
while (C) 

( 

crc.HashPosition(C->Pos() ) ; 

C-C >Next () ; 

I 

return crc . liashkesult () ; 

t 

bool Refresh (const Boards board dong pid) 

// returns true if inimPieces changed 
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. 

Tri-platform Calendaring 


OSX Carbon 
Mac OS 7,1 9.x 
Windows 95-2000 



// returns true if mini Pieces changed 

r 

assert(board♦boardSize==size); 

My Cel 1 * C-cellS: 

cellUst [ 0 ] el 11.1 s l 11 ] -eel 1 Lis L [ 2 ] -0: 

const char* K=boa rd.cell: 

long 1 0 stNumFieces”miinPieces: 

long nPieees=0: 

while (C<sentinel) 

I 

long pValue“(uchar)C*E++>■ 
assert(pValue>^0); 
assort(pValuo<“2); 

IT (pValue) 
nPieees'tt; 

C->SetPvalue(pValue); 

C >Link(cellLis!t IpValue] ) : 

C++: 

I 

numFletces-rtfi eces: 

ulong o1dhash^opponentHash: 

ulong newilash“CoitipiiteOpponentHashCpid) : 

opponentllssMoved“{oldlIash A newliash) : 

opponentHash=newHash: 

return (lastNumPieces !- nPieces); 

1 

I ; 


class My Move 

class HyMove 

I 

MyCell* from; 
short direction: 
short value: 
public: 

void Init, (MyCell * f.long d.long v) 

\ 

f rom^f: 
d E rec l I orv=d : 
value~v: 

} 

long Value0 const treturn value:! 

MyCell * ToCeilO const I return frotn- 
>0ne(direction): \ 

MyCell* FromCellO const {return from:] 
void GonvertMove(Posi11 on• moveFrom*PosiLion * 
movoTo) 

I 

*jnoveFrom=f ram->Fos {) : 

■tnoveTo=ToCel 1 () - >Pos () : 

I 

int operator- (MyMove& b) const {return h.value- 
value:I 
I: 


inline int CmpMoves(const void * a.const void* b) 

MyMove* tna^- (MyMove* ) a: 

MyMove* (MyMove*) b; 
int d=*ma * *mb; 
return d; 


class Computer Player 

class CoTnputerPiayer : public MyBoard 
I 

public: 

ComputerPlayer{int board Size. char pieceValue. 
Boolean piayFirst,int 
sialeitia leThreshold) : 

MyBoard(boardSize). 
piayerid(pieceValue). 
first(playFirst). 
limit(staiemateThreshold). 
staleness(0), 

1 astToCel 1(0) . 

ce 11 StackSt ora ge (new SaveCe11[ lengthj ) . 
cellStack(celiStackStorage). 
ceilStackHnd(celiStackStorage+lengthl, 
maxNumMoves(2 * length), 
moveLiSt(new MyMovefmaxNumMoves]}* 
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CalendarMonster i .2 

Multi-platform calendar 



• End-user Calendar 

The best FMP calendar experience 

- Fast, fast, fast!!! 

- Platform-appropriate user experience 

- Highly scalable 

• Excellent Developer Support 
Quickly and easily integrate 
with your FileMaker Pro projects 

- 100% live data, 100% modular, no plug-ins 

- FileMaker Pro 4 or 5 (including 5.5) 

- As little as 2 ScriptMaker calls 

- Dedicated developers' utility 



ASCENDING 

TECHNOLOGIES 









e ndMoveLifit (moveLi s t +maxKumMoves) 

* 

cel lStackStorsg«->rnit (0*0) : 

J 


void PlacePieees(const 
piecel, 

( 


Boards board.Position* 
Position* pdece2) 


Refrenh(board.playerld); 


MyCell* C1™P1accPIccef )i 
Cl->SeiPvaltte (pi ayerld) ; 
MyCell* C2=FlaeePiece(}; 
*piecel - C1 ->Pos()t 
*piece2 - C2->Fos(); 

I 


bool MovoPiece{const Boards board*bool 
foilowUpMoye* 

Position* muveFroni. Position* moveTo) 

( 

bool restartTimer=Refresh(board.playerld); 
if (restsrtTimer) 

' // tndicuLing a capture since the Iasi turn 
N staleiHsssO; 

OpponentHasMoved = l: 

I //else stalencss-H-; 

// stateness value was planned to select a different strategy when 
// no useful moves are bring made. Not implemented 

LookForTroub 1 e (p layerld) ;// identify vulnerable pieces 

long numMoven; 

If (fol lowlipMove) 

( 

numMoves-MakeFollowUpMoveList (tnoveList. playerld »t rue 

} else if (!opponentHasMoved) 

t 


nuniMoves™M»keUnblockirig,MoveList (rooveUsU piny ft rid ) ; 

) else 

numMoves^MakeMoveList(moveList * player Id * true.0.0): 

if (numMoves<™0) 
return false; 

If (numMoves)l} 

qsorl (moveList * rmniMoves * sizeof (MyMove) . CmpMoves) : 

MyMove* bestMove=RandomizeEquals(numMoves); 
be s tMove->ConvertMove(move F row.moveTo): 
lastToCell=beslMove->ToCeIl0: 
return true; 

I 


private: 

MyCell* PlacePieceO 

// intended to return a good 1 spot to place a piece 

( 

long nuinMove&=MakeP].aceList: (mo veList f player Id) ; 
i f (mimMovos> I) 

l 

qsort {tnoveList * numMoves * sizeof (MyMove) * CtnpMoves) : 

I 

MyMove* bestMove- s RandomizeEqunIs (numMoves) ; 
return bestHove->FromCell(): 


long MakePlaceList(MyMove* M.long pld) 

// returns number of moves in a move Lst. to he used for placement 

MyCell* fromC^CenterCeil(}: 

MyCell* toC=cel XList [0] ;//all (other) empty cells 

long mimWoves-0; 

long raaxMoves=endMoveList-M: 

If f f i r s i ) // second player will have moved fust into the center 
froniC ->SetPvElue{3 - pid) : 


else 

fromC“>SerPvalue(pid); 

while (toC) 

I 

if ((toC 1= fromC) fit & (toC >IsEmpLy())) 
l 

bool iookAhead—true: 
bool mustCapture*^alse: 

long moveValue — EvaluateMoveC M+numMoves, 
fromC, toC. pid. 

lookAhead, mustGapture); 

M[numMovesj ,Init(toC. 0.moveValue); 
numMoves’H-: 

if (numMoves >*“ maxMoves) 

numMoves=PruneMoveiist CM,numMoves) ; 

1 

toC=toC >Next{); 

) 

return numMoves; 


long DoMove(MyCell* fromCell.MyCell* toCell,long 
pid) 

// returns number of captures; 

// leaves all changed cells on the stack. 

1 

Save2Cells(fromCell* toCell); 
toCell->SetPvalue(pid); 
fromCell->SetPvalue(kEmpty): 
long numCaps“0; 

for (int eapDir-0;capDir<4;capDir+f) 

I 

MyCell* target=toCel1 >0ne(capDir); 
if (toCell-)CapLures(target * pid * eapDir)) 

PushCeil(target): 
tar get->SetFvaiue(kEmpty); 
target * >SetThreat(1); 
numCaps-H-; 

I 


// stack=..., fromCc II ,u rt ill, ea pt ured t a rge 11 xapt 11 ret I i a rger2,ctc 

long bestFol1owUps^O: 

if (nunCa p a)// check possibk followUps 

I 

Su veCell * met rk“cel IStack;// mark cell stack so we can 

unwind 

for (int d2=0;d2<4;d2++) 

I 

MyCell* xCell-toCell‘>0ne(d2): 
if (xCeil■>lsEmpty 0) 
l 

long 

followUpCaps"noMove(toCel1.x Co11« pId}; 

if (f ollowUpCaps > best Fol lowtJps) 

I 

be s t Fo11owU ps“fo1lowU pCa ps; 

// keep first follow lip found on stack and quit 

break; 

// (ideally should save on a separate stack, 

// so wc can undo, and keep t>niy the best choice) 

R est orcToMar k(ma rk) ; 

I 

1 

1 

// wlien we return we should liave the board in the slate after the move 
// and all changed cells on the stack. 

// Unrolling the stack will later undo the move, 

return numCups+boutFol 1 owtJns : 

I 

long CountLosses(MyMove* M.MyCell" toCell.long 

pid) 

// On entry, my move (toCell) \us been made on my l>t>ard 

// Now we simulate the opponent s responses, but only in the vicinity of 

my move, 

// Returns maximum number of pieces opponent can capture after my 
move. 
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I’d rather create clocks than invoices. 

If I wanted to keep books all day, I’d have been an accountant. 



Small Business. 


MYOB software is the simplest, most powerful, most complete 
solution for managing my company on the Mac, from the day to day 
to the bottom line. 


Smart Solutions , SM 

Account Edge on the Mac. 
Software includes QuIckBcoks'* conversion 
utility. MYOB also offers conversion service, 

6 0 0,3.2 2. MYOB 
my oh .com/us 


Antique frames. Quartz movements. That’s my business. 

MYOB software works for me. 


^QuickBoaka ifi is Iradamnrk d Jrmiii, Inc. 









I 


long foe“3-pid; 
long d I stance** (toCel 1) ?2 :Qi 
SuveCell* markFcellStack; 
long 

numMoves=MakeMoveList (M.foe .false. distance ,toCell) ; 
if (numMoves) 
t 

if (numMovesM) 
t 

qsort(M. numMoves,s Izcof(MyMove)* CmpMoves): 

\ 

MyMove* bestMove=M; 
return M‘>Value(): 

I 

return 0: 


long PruneMoveliSt{MyMove* M.long numMoves) 

// if allocated movclist gets full, this routine is used to: 

// remove the lower value moves to reduce list by 1/4 

( 

qsort (M,numMoves.sizeof(MyMove).CmpMoves) ; 
return numMoves/2 + numMoves/4: 


long MakcUnbloekIngMoveList(MyMove* M.long pid) 
// returns moves which might free a blocked opponent 
l 

MyCell* frowC^cellList[pid]; 
long numMoves—0; 
long maxMoves^endMoveList-M: 
while (fromC) 

\ 

if { { f romG >PValue'0*"pid) && 

(fromC MiasNeighbor{3 pid))) 
for (itit di r=0 ; di r<A ;dirH-) 

I 

MyCell* toC-frotnC- >One (dir) : 
if CtoC->PValue{)) 
continue: 


long nioveValue 
f romC* toC. pid » 


Evalua leMove (M^nutiiMoves . 

true. false); 


M[numMoves].Init{fromC. dir .moveValue): 
numMoves++; 

if {numMoves >= maxMoves) 

numMoves”PrunoMavol1st(M,numMoves): 

1 

fromC*=fromC >Next(); 

l 

return numMoves; 


long MakeMoveList(MyMove* M.long pid*bool 
lookAhead.long distance,MyCell■ xCell) 

// returns number of moves in list 

l 

MyCell* fromOcellList [pid] ; 
long numMoves=0: 
long maxMoves-endMoveList-M: 
while (fromC) 

{ 

!f ({fromC- >PVa 1 tie()“pid ) && 

( (d iGtance=0) || (fromC 
>D ±stance (xCell) C=distance))) 

I 

for (int dir=0:dir<4;dir++) 

l 

MyCell* toC—fromC - >One (dir ) ; 
if (toC■>P¥aluo ()) 
continue; 

bool mustCapture=faIse: 

long raoveValue = EvaluateMove(K+nutnMoves, 
fromC. toC, 

pid. lookAhead.raustCaptUre); 

M[numMoves]* lull(fromC.dir.moveValue): 
numMoves++; 


if CnuniMoves >= maxMoves) 

numHoves=PruneMo ve1is t (M.numMoves ); 

) 

) 

ir oroC—fromC->Nex t (): 

J 

return numMoves; 

I 

long MakeFollowUpMoveList(MyMove* M ,long pid .bool 
lookAhead) 

I 

// generates only capturing moves by the last piece moved, 

// should only be called with follow Up after another move 
MyCell* fromC—lastToCell; 
assert(fromC); 
long numMoves^G; 
long maxMoves=endMovaLlsT-M; 
for (int d1r-0;dlr<A:dtr++) 

I 

MyCell 1 toC=f romO>0ne(dir); 
if (ltoC->IsEmptyO) 
continue: 

bool mustCapture - true; 

long movoValue * EvaluateMove(MtnumMoves. 
fromC. ToC. pid. 

lookAhead. must.Capture) : 

M[numMoves].init(fromC.dir.moveValue); 
numMoves+t; 

if (numMoves >= maxMoves) 

numMove s=P r un eMove 1 ist{M. nvimMove s) : 

I 

assert(numMoves); 
return numMoves; 

I 

long EvaluateMove(MyMove* M.MyCell* fromC, 

MyCell* toC, 

long pid, bool lookAhead, bool 

m u st Capt uro) 

// executes U move and accounts captures and losses into a 'moveValue 

SaveCeli* mark=cellStack; 

long numCaps^DoMove(fromC.toC.pid); 

if (mustCapture && numCaps<"0) 

l 

Res to reToMark(mark )* 

return 1engtb*kCapturoFaeror; 

1 

#if DBG 

RedrawBoard(); 

#endif 

long 

numLost=(lookAhead3 TCountLosses(MltoC.pid);0: 

RestoreToMark(mark); 

//if DBG 

Red rawRosrd () ; 

//end if 

long moveValue * kCapturefactor* 

{fromC->Threat(3+numCaps- 

numLost); 

return moveValue; 

l 

MyMove* Random!zeEquais(long numMoves) 

// instead of always taking the first move from the Jist we choose 
randomly 

// among the first equal valued moves. 

1 

long numfiqual=l; 

MyMove* endMovc^movoLlst+numMoves: 

MyMove* ra=moveLlsL; 
long bestVaiue=m'>Value(); 
while (+-hn < endMove) 

( 

if (m->Va1ueO >= bestValue) 
t 

numEqual++; 

) else break; 

) 
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Made with 



REALbasic® 


REAL Software and MacTeeh present the REALbasic Showcase to 
highlight some of the fantastic solutions created by REALbasic users 
worldwide. Lhe showcase illustrates the wide range of applications that 
developers using REALbasic can create. Some benefit any Mac user, and 
others are more specific. All of them are seriously cool! 

REALbasic is the powerful, easy-to-use tool for creating your own 
software for Macintosh, Mac OS X, and Windows. It runs natively on 
Mac OS X as well as earlier versions of the Mac OS. For more 
information, please visit: <www.realbasic.com>. 

The Made with REALbasic program is a cooperative effort between 
REALbasic users and REAL Software, Inc. to promote the products 
created using REALbasic and the people who create them. For more 
information about the Made with REALbasic program, please visit: 

<www.realbasic.com/realbasic/mwrb/Partners/MwRbProgram.html>. 








REALBASIC SHOWCASE 



Extend REALbasic with 
Advanced Plugins 

Spreadsheet Controls: 

We provide a wide range of spreadsheet controls for 
REALbasic, including multistyled and custom rendering 
spreadsheet controls. 


A 

U 

C 


This 

is some incredible list 

- 

€=> 1 

Stunt text 

Mora load 

1 

©9 t 

Seme hod 

Mora taxi 

Os? 3 

Sairt* text 

More Iffxi 

09 4 

Same text 

Mora 1*xl 


0» 5 

Spnne text 

Mon taxi 

— 

$ 

Some text 

Matt Iml 


€9 7 

Sortie text 

Mora taxi 


04 8 

Some text 

Mon last 


ML 



■ More than 32k of rows. 

► Classic, OS X and Win32. 
1 Accelerated for maximum 
speed 

■ Images in cells. 



OIIOOIO 


Cryptography: 

We provide data encryption, encoding, 
compression and hashing for REALbasic. 

Supported Algorithms: 

• Encryption: 

- e-Cryptlt 

- BlowFish (448 bit) 

- AES (Rijndael) (256 bit) 

■ Encoding: 

- e-Crypttt Flexible 

- Base 64 


- BinHex 

- MacBtnary IN 
-AppleSingle / Double 

- UUCoding 

* Compression: 

-Zip on Strings and streams (gz) 

• Hashing and Checksums; 

- CRC32 /Adier32 

- MD5 / HMAC_MD5 
-SHA/SHA1/HMAC_SHA1 


Other Plugins: 

We have many other 
plugins for REALbasic, 
including plugins to do 
advanced MacOS 
Toolbox tasks and more 
custom Controls. 




Speed up developement and make 
more advanced applications 
by using plugins ! Get free demos 
at www.einhugur.com 




Einhugur Software 
sales@einhugur.com 
' www.einhugur.com 


I, 


Corona 

accounting software 


"Easy to set up, easy to use, 
and excellent support from 
the developer." 

Five stars on VersionTracker.com 

• account chart 

• address index 
• help facility 

$ 49-95 

Free 30 -day trial 

http: //home page, mae.com /idlewild / Coro nallS. Iiqx 


A best friend for business! 

p.o box 3164 ■ newberg ■ urc-gon * 971*12 
klievriidQmac com 




• cash entry 
• invoicing 

• payroll 

• reports 



Picture Play 


C'reatc dijnial callages on your Mac* quick!) ami easily 

< tmhuii digital photo *. dipan. unwythm i lx make a h oti of ait in m i»w ' 
Fkiuk a Hiiiiitiw antiptAnrfttl* imyh to k nan J by ifanit 
bnimt iovmftitx that first um mm nillk knthktvtf 
iinttit whk ti ntlf ktym nmk »<}tkkrful amptmtms mn amply tbm (USE 

Only t’SSiO. far Mm as * anti Mlc OS X, 

Owrc k if owl b> *oin£ lo feUp;/faw**(f¥tttod0itt*cftm/ ftdiy l 
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REALBASIC SHOWCASE 




Advertising helps you build your brand. After alt, you 
don't expect someone tobuy your product if they’ve 
never heard of you , do you? 

Alt products/servkes made with or relatedto RE At basic 
qualify to be a part of our exclusive marketplace section, 

Are you looking for extremely small our of pocket 
advertising that wilt reach your target audience? 

We bill you for ads monthly as each issue ships . 
Contact our ad sales team today for more details. 

Voice: 805-494-9797 xl 13 * eMaihadsales@mactech.com 



www.mactech.com 




lRT sleep design 

FontViewer 


FontViewer is o simple but elegant font viewer that allows you to 
preview oil fonts in vour fonts folder ; They can be displayed in 
various sizes and styles with the click of a mouse. FontViewer also 
features the ability to display your fonts in a slideshow, and view 
your fonts in almost every type of environment possible (i.e 
desktop , menus , icons, etc.) 

Creative Box URL: http: //www.creafi vebox.net/ 
Developer e-mail: jason@ereafivebox.net 



piDock 


piDock is the must have navigation and launching utility for 
A/lacOS, Now you con easily organize , navigate and launch 
files with a simple sweep of the mouse . 

Compatible with OS 8.6 through TO.?, OSX users can now 
control-option dick a folder to navigate it f s contents. 

http://www.pidog.com * http://www.pidock.com 
piDock@pidog.com 



v 



/Screensaver 

Designer 

for Macintosh and Windows 



the world's only cross-platform 
screensaver design tool 

• build both Macintosh and Windows screensavers 
with a single click, on whatever system* you are using/ 

* use any QuickTime movie format : 

Macromedia Rash, MPEG, Cinepak, MP3, Midi, AVI, DV Video... 

* include a hidden movie that can be unlocked 
with a registration code 

• customize and fully-brand both Instailers 
and Screensaver control panels with pictures and text 

• screensavers install without DLLs, extensions, or restarts 


simple 

WYSIWYG 

editor 

supports 
Interactive Hash 
and QuickTime 


consistent 
cross-platform 
user interface 


try before you buy 
fully functional 
online do wnloads 


h ttp:/iScreen sa ver. net 

email : info @ {Screensaver, net 



the iScre&>&QV& Oengnt# shitty Hnwrmment 


* supported systems, os of November 2001, jncluite: 

Macintosh 05 8 6 to %.l. MtCrOSOff WMdOwS 95/WMC, NT<VNT2(HHJ/XP 



February 2(X)2 * MacTecji 


71 



















































■ REALBASIC SHOWCASE 



.^P s ° f t 


StimpSoft™, Inc. 


StimpSoft™, /nc. Makers of insanely 
mediocre software for cots, dogs, voles f 
wallabies, mangos, crickets, and 
people. We put the tr L n in "Software". 

URL: http:// www.5timpsoft.con1 
Email: john@stimpsaft.com 


y abDataTools 


db Reports is a cross-platform report writing application able to 
extract, format and print data from one of various data sources. 
A multitude of built-in features and expressions make db Reports 
a powerful tool for analyzing data. 


Free demo and more details located at 
http://abDataTools.com 



MAC MUSIC MANAGEMENT FOR 
SONY® 5 TO 400 DISC CD CHANGERS 



Control up to 12 changers (4,800 music CDs) 
Control Any Brand Stereo Receiver 
Play MP3 and other Sound Files 
Plus much, much more!!! 


www.titletrack.com info@titletrack.com 



Whistle Blower 

Enterprise server monitor and restart utility 
whistleblower.sentman.com 

Connect to and validate the response from web servers, 
cgi scripts and over 23 other types of servers . 

Send email , pages and perform unattended restarts via 
MasterSwitch or PowerKey. 

Shifts make sure that the person on call when the server 
goes down rs ftie one who gets the page . 

68k, PPC and Carbon 

Web based administration lets you check on and restart 
your servers from anywhere* 

Customize your response to an outage with Apple Script 

email us at whistleblower@sentman.com 
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assert CimmEqual) t 
if CimmEqual >1) 

return moveList+( rand ()%mun£qual) ; 
return &moveList[0]: 


void CloarThreatsO 

( 

MyCell* C«cells; 
while (CCsentitiel) 

I 

C->SetThreat(0): 
C H-; 

I 


void LookForTrouble (long pid ) 

//Assign ;i 'threat' value of l to :UI pieces that could he taken by the 
opponent 

//This is done impbcitcLy by creating a dummy moveUsl for the 
opponent, 

I 

ClearThrears(); 

MakoMovcList(movcList.3 pld,false.0,0): 

) 

// Stack operations for saving ami restoring cell states during move 
exploration 

void PushCnl1(MyCel1 * C) 

\ 

assert (cel 1 Stack+Kcel iStackEnd) ; 

{ ++ c t? 11S tack) > I n i I ( C . C - >PValue ()) ; 
l 

void FushBlankC) 

t 

assert (eel IStack+KeellStackEnd) ; 

(44ce11S t aek)->Init(0. 0 ) : 

\ 

void Save2Cells{MyCell* Cl.MyCeli* C2) 

l 

PushCeii(Cl): 

PushCeli(C2); 

I 

void PopCell() 

t 

My Cell* OcellStack->C; 
assert(C); 

C >SetPvaiue(celIStack >v): 
eeliStack-; 
l 

void Restore2CellsO 

I 

PopCell0i 
PopCell(); 

I 

void RestoreCells(long n) 

for (int i*=Q;i<n;i++) 

PopCellO: 

I 

void RestoreToMark(SaveCell* mark) 

( 

while (cellstack>raark) 

f 

PopCell(): 

) 

\ 

ilf DBG 

void RedrawBoardO 

l 

Position p: 

MyCell- C=cells; 

for (p.row-O;p,row<size;p,rov++) 

( 

for (p,col”0;p*col<size;p,col++.C++) 

t 

long pvalue=C->FValue(): 
gDisplay->PaintSquare(p.pvalue); 

I 

gDisplay->Run(p); 


//endf f 

uchar player Td -Jt l or 2 
bool first; 
long limit; 
long staleness; 

MyCell 1 lastToCell; 
SaveCell* cellStackStorage: 
SaveCell* cell Stack; 
SaveCell* celIStackEnd; 
long maxNuniMoves; 

MyMove* moveList; 

MyMove* endMoveLlst; 

1 ; 

//"end if 

SeegaWindgw.h 

//ifndef SEEGA WINDOW H 
//define SEEGA WINDOW H 


//include "seega.h" 

//include <assert,b^ 

//include <string, h> 

//include <stdio,h> 

typedef unsigned char uchar; 
typedef unsigned long ulong; 

enum i 

kMaxSpacing— 32* 
kMinSpacing “ 5* 
kLegend Space 30 12, 
klnset ** 2. 

kSelf =16, 
kOpponent — 32* 
klnvalidSquare — 64. 

kSeleetColor “ 2 
I I 

const RGBColor RCBGrecn= I 0x0000 . OxCFFF *0x0000 \ ;// 
center box 

const RGBColor RGBRed= I OxAFFF * QxOOQQ , 0x00001 ; // 
player! 11 boxes 

const RGBColor RGBLightRed- IOxFFFF,0x8000.0x0000 I : 
// selected player ( IJ boxes 

const RGBColor RGBBlue* I 0x0000 * 0x0000 * QxAFFF I ;// 

playcr|0| boxes 

const RGBColor RGBLigh l B1ue= 

10x0000.0x8000 * OxFFFF): 

// selected player) 0J boxes 

const RGBColor RGBWhite-(OxFFFF*OxFFFF*OxFFFF1: 
const RGBColor RGBGray= I 0x1FFF,Ox 1FFF f Ox 1FFF3 ; 
const RGBColor RGBBlack“t0*0*01; 

const RGBColor gBoxColor(5) ~ 

// color for empty, first and second players 
I 

RGBWhite*RGBBlue* RGBRed* RGBLightB1ue P RGBLightRed 

) ; 


struct SccgaBoard 

long gBpacing; 
long gMargin; 
long size: 

WindowFtr window; 
long roySquarna; 
long oppSquares; 

Board * board ; if logical board 

SeegaBoard(long boardSize.WindovPtr 
colorWindow,Board* brd); 
size(boardsize)* 
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RADGAD 


The Place for Useful Gifts & Gadgets.™ 
877-5-RADGAD 











window(colorWindow), 
mySquares(0)* 
oppSquarea(0) . 
board Cbrd) 

I 

long windowWidth"window->portRect« right 'window- 
>portRoot /Inf t ; 

long wiudowHoighT=window->porrRect.hottom - 
window >portRcct.top: 

gSpacings (windowWidth< = windowileigiiL) ? witidowWid ih : wi 
ndouHeight; 

assert Eg5pacing> (klneet+klnset) *size) : 
gSpacing/=(size^13 : 
gMarg E n“gSpac 1 ng/ 2i 
Set Port (w I ndow) : 

DrawGrid(} ; 

Position ceuterPH >ize/2 * size/2 ] ; 

PaintSqttare (centerP. 0) ; 


void Label Square(F or j 13 on p,unsigned long 
colorValuG,long label Value) 

PaintSquare(p,colorValue ); 

long L=gMargin+kInset + p,col* gSpacing: 

long T~gMargin+kInset+p.row* gSpacing+gSpacing/2; 

MoveTo(L ♦ T); 

Str255 ntr: 

If CcolorValue**0) 

RGBForoColor (£*RGBBlack) ; 

else 

ROBForeColor{&RCBWhite): 

NumToString{labelValue,atr); 

DrawString(str); 


void Pal n 1:5quare(FositIon p*unsigned long value) 

I 

assert(value < 5); 

RGBColor color = gBoxColor[value]: 

RGBForeColor Ucoior) ; 
long L-gMarginIklnsetIp»col*gSpacing: 
long T"gMargin+kItiaet+p. row*gSpacing; 
long R-L+gSpacing-I kinnet: 
long R^T+gSpaclng I klnaet; 

Reel reci~iT*L,B*R]: 

PaintRect(&rect): 

if ( (p, row=si 2 eV 2 ) && (p .col^p. row)) 

I 

RGBForeColor f&RGBGreen); 

Reer center"IT+gSpacingM * L+gS pacing/ h ♦B 
gSparIngM,R-gSpae3 ngMI : 

Pn inrRocr {kemer); 

1 

I 

void DrawGridC) 

I 

SetPort(window) ; 

RGBColor gr idCo 1 or-RGBGray ; // {Gx I FFF.Ox J FFFl \X 1FFF) * 
RGBForeColor (fcgrIdColor): 
f ti r (long row^O ; r ow<^size ; row++) 

( 

long x=gMargin; 

long y^gMargin+row^gSpacing: 

MoveTo(x.y); 

LineTo(x+gSpacing*siEe,y) ; 


for (long col^Otcol< = sixc;col++j 
( 

long x^gMargin+eol'gSpacing; 
long y^gHargin; 

MoveTo(x, y): 

LineTo(x*ytgSpacing*size) : 

1 

J 

bool ClosestPosition(const Point mouse * Position & 

p) 

// returns false if dirked outside of active window 


I 

long hdist“mouse.h-gMargin; 
if ((hdist<0) || (hdist>^gSpacing*si£e)) 
return false; 
p, c o 1 ' r hd i s t / gS pa c l ng; 
if (p.eolXQ) p.col™0: 
if (p.col>(size-1)) p,col*sire-l; 

long vdist^mouse.v-gMargin: 
if ((vdist<0) || (vdist>^g5pacing*size)) 
return false; 
p„row=vdIst/gS pacin g; 
if (p.row<0) p*row**Gi 
if (p*row>(size -1)) p.row“s±ze 1; 

assert(p*row>“0 kk p.col>-0): 
assert(p,rowCsize && p.coKsize): 
return true: 

\ 

bool Rut ( Posi tion k p) //returns into if position selected 

( 

Boolean gotEvent; 

EventRecord event; 
do 1 

SystemTask(); 

gotEvent = GetNextEvent(everyEvent* kevent); 

if ( gotEvent ) 1 

int rc=DoEventE^event*p); 
if (rc) 

( 

if (rc>0) 

( 

assert(p»row>^0 && p.col>=0); 
asaeri (p . row<size txi* p.col<size) : 

i 

return (rc>G); 

1 

1 

) while ( true ): 
return false; 


int DoEvent (EventRecord * event * Position in p) 

// returns l if numse click inside field 

// returns -1 if key hit or mouse click outside field 

// else returns 0 

l 

switch ( event >what ) I 
case mouseDown; 
l 

long part - FindWindow(event *>where. 
^.window) : 

if ( part — inContent) 

( 

Point mouse “ event >where; //get the click 

position 

GlobalToLocal(femousc); 
long L=mouse*h; 
long T=mouse.v; 

if (!ClosestPosition(mouse.p)) 
return * l : 

assert (p- rnw^O kf* p.col>=0); 
assert ( p » row<s i zo bk ze) ; 

return 1 ; 

\ 

break; 

I 

case keyDown:assert(0); 
case autoKey; return 1; 

I 

return 0: 

I 

I ; 

/fend if 
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There are some things in life you 
can never have enough of... 



Built-to-order. Lifetime Guarantee. Competitive Pricing. 



www.devdepotcom/memory 

Voice: 877-DEPOT-NOW (877-337-6866) • Outside US/Canada: 805/494-9797 

E-mail: orders@devdepot.com 
















AdobePress 

Training and inspiration for digital communicators 


SAVE 

30 %*.. 


BORDERS 


B0OKS*HUSIC*HOVre$‘CArE 





*30% off select titles 12/30/01 through 1/27/02* 

CLAS W>K 


Available at: 


BORDERS' 


Adobe Acrobat 5.0 Classroom in a Book 
Adobe After Effects 5.0 Classroom in a Book 
Adobe Illustrator 9.0 Classroom in a Book 
Adobe Photoshop 6.0 Classroom in a Book 
Adobe Premiere 6.0 Classroom in a Book 


BOOKS*MUSIC»MOVI E S•C A F E 













The below news headlines recently crossed our news desk, For more information on 
each of these items, check out the MacTcch web site <http://wwwimctech,com> and 
search out the below headlines from the home page. 


■ e-Crypt 11 Engine for RKALbasic 

* BenaTong announces 
PowerGuardian(tm) for OS X 

* 4D t I nr. ships 41) WebSTAR 5.1 1 with 
Fast CGI 

* THE DATA WE1I CENTER OPENS AS 
THE ONE-SYC )P LASSO EXPERIENCE 

* Creinax Launches Soho Raid Product 
Line 

* Blue World Releases Lasso 
Professional 5 

* SQLBass Developer VI.2c is ready 
for download 

* IOGEAR electrifies the hard drive 
market with ION 

* Objective Development Announces 
launchbaf 3.2 Beta For Mac OS X 

* TECSofl Announces AppleScript for 
Success Seminars 

* Glass Bead Software releases 
SnapTalk 3 Beta 

* Mac OS X Palm Conduits for Power 
Oris Now Up-to-Date & Contact 

* Ten oris iTtx>ls 6.5.1 now available 
with added features & security 

* Ekim Software releases MailCall 2.0 

* TextSpresso 2.0bl for Mac OS X 

* 4D Business Kit Now Shipping 

* Acfive4D 2.0 final released 

* BASh vl .7.0 Released by Deep Sky 
Technologies 

* lconfactory: Las Vegas Collection for 
OS X Released 

* Mergcmil) 1,5 

* Atomik 3,0 

* VINC 1.0: integrated Document 
Viewer And Converter Application 

* Big Nerd Ranch Announces March 
Cocoa Training 

* OS-Odessa Announces Availability Of 
Conceptdraw 1.7.5 

* Brushfire 1,5: Filemaker Pro Script 
Analysts Utility 

* Valentina 1.8.10 Advances Cocoa and 
SQL Support 

* Speed tests added to IPNetTuner 

* Project Timer - Time Tracking 
Software for Mac OS X 
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Wiidpackets Academy Introduces Wel> 
Delivered Training 

Introducing JOG EAR Mini USB Optical 
Mouse 

Intclli Innovations Delivers IntdliMerge 
2.0 

Web Crossing V,4,1 Update Now 
Available And Twice As East 
Real Software To Reward Apple Design 
Award Honorees With Apple 
InterMapper Remote 1,0, release 
version 

DeskTop GB Now supports 120GB, 
160GB 

ChronoSync: Easy File Synchronization 
to Mac OS X 

Full Screen Player IT for Mac OS X 

Default Folder X 1.0.1 

IconBuildcr Pro 3.1 

IIarpoon3 OSX update 

Friends of Time extends QuickTime 

community web services 

iEvents 1.4 Released 

Image Rodeo: a template-driven iPhoto 

alternative 

Gptigold ISP 2.9.3 

El MS Admin 3X1 and E1MS Admin X 
3*1.lal now available 
NameCleaner X 2.5 
Multt-DBServer for Macintosh 
MySQLConnetl for 4D 1.0.4 
REAL Software While Paper: Difference 
Between Carbon and Cocoa 
SimpleText Filter 1,2 for E1MS Released 
Trinfinity Software Releases Seagull 
Video Player 2.0 
Beetle, a Low Cost 802,11b 
Maintenance & Installation Tool 
MacVCD 3*2 Released 
Mega-Mailer L2 a powerful mass- 
mailing solution for FileMaker 
Alpha8 8.0b 1 & AIpliaTe) 7.5 Released 
Web Dumper vl.2 
Apple Previews Quicklime 6 w r ith 
MPEG-4 

Apple Previews New QuickTime 

Broadcaster Software 

MacASP 0.91 adds OS X support and 

more 



REALbasic 


DeuDepot your source for the 


Smallest Drive Available! 
Bus Powered! 


Haiti Drives! 


Far Poweiflookm 
or Besktopl^SE 
Best Prices!?* * 


REALbasic 4.0! 

imBmml&Snii 




J.'rAVjJ '•nr*', 

nsiHT jfcrjr 
wc Iav Si: r$< 


Pre-Order Now! 


honest new Tech Tools! 


www.devdepet.com 


Voice: K77-DKPOT-NOW (877-337-6866) 
Outside US/Canadn: 805/494 9797 
E-mail: ordeH@dcvilcpol.com 
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SuSE Linux 7.3 

• Secure 

• Stable 

• Superior 


fiifiux 


PowerPC EDITION 7.3 


SuSE Linux 7.3 
PowerPC EDITION: 

$ 79,95 


Yes, please send me the power-pack ,* 


Please bill the following address: & 


because Linux users enjoy the power and stability of SuSE Linux, 

Don’t compromise. company 


SuSE Linux 7.3 - no limits. 


Last name/Name 


Full integration with MOL 
(Mac-Gn-Lmux) 

Scanning made easy with the 

KDE tool Kooka friaro 

Protect your data with Soft-RAID CHS 


Great sound with ALSA 
Surf safely with the Personal Firewall 
Professional installation support by 
phone, fax and e-mail 
* etc. 


Phone 


Street 

Zi p-code/Postal-code 


SuSE Inc — The Linux Experts 

580 Second St 
| Oakland * CA 94607 


□ SuSE Linux 7.3 PowerPC EDITION 
S 79.95 


Order Online Today! http://shop.suse.com/mt 

lnfo@suse.com (^) (888) 875-4689 (2) (510) 628-3381 
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BP® 


Other software companies have customers. We've 
got fans. In fact, Metrowerks is the leading provider 
of development tools for the Macintosh® commu¬ 
nity. With Metrowerks CodeWarrior” tools, you 
can build powerful applications with our popular 
PowerPlant" framework, which uses industry- 
standard C++. Best of all, you can create a single 
application that runs on both Classic Mac® OS and 
Mac OS X. So choose CodeWarrior tools and get 
ready to rock. 


Register now to win an iPod™ MP3 player at 
www. metro wer ks.com/mactech. 



CodeWarrior 

Development Tools for Mac 3 OS 


CapyrruhE. £002 Metrowerks Carp. ConkWarrior, PowerPlard, Metrowerks arid IN Molrowurfcs logo are trademarks or rostered trademarks of Metrowerks Corf. In m 
ULB. and/or athor c<M.irti law Macintosh and Mac are registered trademarks and iPod is a trademark of /topic Caihpiita, Inc. AU RIGHTS HESEUWEO. MGaaei9A-ttIC02tt 


metrowerks 
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